Back to Details

spec-proofreader

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Spec Proofreader Skill

Spec Proofreader Skill

Read and follow agent-conduct before starting.
You have NO knowledge of the original feature description. Review the spec purely on its own merits as a written document.
开始前请阅读并遵循agent-conduct规范。
你不了解原始功能描述。仅从书面文档本身的角度审查规格文档。

Input

输入

  • Spec path only. Do NOT receive the feature description.
  • 仅接收Spec path（规格文档路径）。不接收功能描述。

Procedure

流程

1. Read the entire spec.

1. 通读整个规格文档。

2. Check for text errors

2. 检查文本错误

  • Repetition: same thing said in different words; redundant acceptance tests.
  • Contradictions: conflicting statements (e.g. type defined differently in two places).
  • Undefined terms: types, functions, packages used without definition.
  • Placeholder text: TODO, TBD, incomplete sections.
  • Cross-references: all internal references resolve correctly.
  • 重复问题： 用不同表述说同一件事；冗余的验收测试。
  • 矛盾问题： 表述冲突（例如，同一类型在两处定义不同）。
  • 未定义术语： 使用未定义的类型、函数、包。
  • 占位文本： 存在TODO、TBD或未完成的章节。
  • 交叉引用： 所有内部引用需能正确解析。

3. Check structure and numbering

3. 检查结构与编号

  • Sequential section letters (A, B, C...) and story numbers (A1, A2, B1...). No gaps or duplicates.
  • Every story ID in implementation order exists as an actual story.
  • Every story appears in the implementation order.
  • All acceptance tests are inside user story blocks.
  • All stories are under matching 
    ## Section <Letter>:
    headings.
  • 章节字母（A、B、C...）和用户故事编号（A1、A2、B1...）需连续，无缺失或重复。
  • 实现顺序中的每个故事ID都对应实际存在的用户故事。
  • 每个用户故事都按实现顺序排列。
  • 所有验收测试都包含在用户故事块内。
  • 所有用户故事都归属于对应的
    ## Section <Letter>:
    标题下。

4. Check formatting

4. 检查格式

  • 80-column wrap (code blocks exempt). ASCII only (no em dashes, smart quotes, special chars outside code blocks).
  • Consistent whitespace, no trailing whitespace, no consecutive blank lines.
  • Code blocks specify language. Proper heading hierarchy.
  • 文本宽度限制为80列（代码块除外）。仅使用ASCII字符（代码块外不允许使用破折号、智能引号或特殊字符）。
  • 空格使用一致，无尾随空格，无连续空行。
  • 代码块需指定语言。标题层级规范。

5. Fix errors directly. Keep fixes minimal. Check codebase only to resolve

5. 直接修复错误。修复需尽可能精简。仅可通过检查代码库来解决歧义问题。

—

6. 结论

ambiguities.
  • PASS - 未发现错误。
  • FIXED - 列出所有错误及修复方式。

6. Verdict

规则

  • PASS - no errors found.
  • FIXED - list every error and how it was fixed.
  • 不得检查功能覆盖情况（这是spec-reviewer的工作）。
  • 不得评估技术设计。
  • 不得添加新内容。
  • 仅可修复文本错误、格式问题、编号问题及一致性问题。

Rules

—
  • Do NOT check feature coverage (that is spec-reviewer's job).
  • Do NOT evaluate technical design.
  • Do NOT add new content.
  • ONLY fix text errors, formatting, numbering, and consistency.
—