musepi-prose-standard skillA
musepi-prose-standard is agent-read markdown (skill) from muselinn/musepi: MusePi 代码库的文案/注释标准——写"契约"而不是写过程：删推理过程、重复和装饰，一处事实一个家；覆盖 JSDoc、代码注释、prompt .md、i18n 文案、GUI 可见字符串、CHANGELOG、docs。触发：写/审/改注释、文档、prompt、用户可见文案，或"这个注释太啰嗦 / 文档怎么组织 / 这段话怎么改"。.
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
# MusePi 文案标准
写得足以保住契约，然后删掉推理过程、重复和装饰。**契约**是调用方、被调方、实现方、
生产者或消费者依赖的义务、不变量、前置/后置条件或兼容性承诺。本 skill 负责编辑判断
与必要覆盖面；清理"思维链泄漏"（死会话引用、变更叙述、评审对白、控制流叙述、含糊
推迟）用 `skill://musepi-trim-cot-leakage`。这是指导，不是脚本。
注释描述代码无法表达的**非显然契约或理由**；不复述代码已经明说的事实。不要把
`契约/边界/形状/表面/缝/门/词汇` 当禁词：先问更精确的词是不是更好（写 `响应字段`、
`JSON 校验`、`ESM 导出` 而不是 `响应形状`、`校验边界`、`模块形状`），但调用方/被调方
契约、安全/进程边界就该叫边界。
## 保留完整命题
改动一段文案前，先列出其中的每个命题，逐一保留：
- 行为者和动作；
- 条件、时序、顺序；
- 情态（必须/可以/绝不）；
- 否定保证与例外；
- 所有权、副作用、失败模式、后果。
只有当每个事实分句都存活且更清晰时，才删形容词、重复和叙述。**字数变少本身不是
改进。**
- 在用法处保留完整的本地契约：那里需要的行为、失败、所有权、后果。架构、理由、算法、
历史、扩展例子一律链接到归属文档。一个解释只有一个家；关键契约事实可以在本地重复。
- 保留非显然的理由——省略它可能导致误用或错误简化时；否则写后果并链接理由的家。
## 各位置的必需覆盖面
这不是单向删减：当代码、类型、结构传达不了下面的契约时，要**补**文案；本地已显然
的事实不加注释。
- **公开 JSDoc**：写调用方可见的返回区分、抛错/拒绝、副作用、所有权、时序、取消、
持久性。函数式导出带 `@param`/`@returns`。
- **内部注释**：定位非本地结构与明显复杂的本地结构——不变量、竞态次序、所有权、
安全边界、意外的失败行为。删控制流叙述和代码复述。
- **prompt 文件**：prompt 一律是静态 `.md`（AGENTS.md 规则：禁代码内拼 prompt），
Handlebars 做动态内容。**措辞即行为**：改动 prompt 视为行为变更，需要 snapshot/
测试佐证。
- **i18n 文案**：走域文件（`guest-client/src/i18n/{zh-CN,en-US}/<domain>.ts`、
`coding-agent/src/i18n/zh-CN/`），zh 加 key 必须同步 en（en 域文件
`as const satisfies Record<ZhKey, string>`，缺 key 即编译错）；插件/扩展文案走
…Read the whole file at its exact version.
How to install
mdr add muselinn/musepi/musepi-prose-standard@git:20260909.1dfc4d6mdr add muselinn/musepi/musepi-prose-standard@sha256:882a4a8643317474Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_h4ca5fil6afpeu5k)
1 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| git:20260909.1dfc4d6 latest | 2026-09-09 | 1dfc4d6 | 4,904 B | A | view · diff |
| git:20260823.0df9512 | 2026-08-23 | 0df9512 | 4,903 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (4904 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
muselinn/musepi · 17 stars · license MIT · pushed 2026-09-23 · branch main
API
GET https://markdownregistry.com/api/v1/artifacts/art_h4ca5fil6afpeu5k GET https://markdownregistry.com/api/v1/resolve?ref=muselinn/musepi/musepi-prose-standard GET https://markdownregistry.com/api/v1/blob/882a4a8643317474af55fd0847e24988b2c35a1aa3a2224a7c299895376184b0
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.