tpm-spec-trace-ids

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

PRD Vision Annotator

PRD愿景标注器

Annotate a narrative vision document with traceable Feature IDs and generate a Coverage Index.
为叙事性愿景文档添加可追溯的Feature ID并生成覆盖索引。

Workflow

工作流程

  1. Add Goals section (if missing) — Extract or write 3-10 business objectives as G-01, G-02, etc.
  2. Assign Feature IDs — Add
    [F-nnn]
    tags to major section headers
  3. Generate Coverage Index — Create tracking file listing all features
  1. 添加目标章节(如缺失)——提取或撰写3-10个业务目标,格式为G-01、G-02等。
  2. 分配Feature ID——为主要章节标题添加
    [F-nnn]
    标签
  3. 生成覆盖索引——创建跟踪文件,列出所有功能点

Step 1: Goals Section

步骤1:目标章节

If the vision PRD lacks explicit goals, add them at the top:
markdown
undefined
如果愿景PRD缺少明确的目标,在顶部添加:
markdown
undefined

Goals

Goals

G-01: [Primary business objective] G-02: [Secondary objective] G-03: [Quality/compliance objective]

Extract goals from executive summary, introduction, or ask the user.

If the document contains goals already, add goal Ids and do not modify those pieces of prose.
G-01: [Primary business objective] G-02: [Secondary objective] G-03: [Quality/compliance objective]

从执行摘要、引言中提取目标,或向用户询问。

如果文档已包含目标,只需添加目标ID,不要修改原有文字。

Step 2: Feature ID Assignment

步骤2:Feature ID分配

Add Feature IDs to major section headers. Do not modify prose.
Before:
markdown
undefined
为主要章节标题添加Feature ID,不要修改原有文字。
修改前:
markdown
undefined

14. RSVP Functionality

14. RSVP Functionality

14.1 Process Flow

14.1 Process Flow


**After:**
```markdown

**修改后:**
```markdown

14. RSVP Functionality [F-014]

14. RSVP Functionality [F-014]

14.1 Process Flow

14.1 Process Flow


**Rules:**
- One Feature ID per major section (H2 level typically)
- Subsections inherit parent ID unless substantial enough for their own
- Number sequentially (F-001, F-002...) or match section numbers (§14 → F-014)
- Skip sections explicitly out of scope

**规则:**
- 每个主要章节(通常为H2级别)对应一个Feature ID
- 子章节继承父ID,除非内容足够独立可拥有自己的ID
- 按顺序编号(F-001、F-002...)或匹配章节编号(§14 → F-014)
- 跳过明确标注为超出范围的章节

Step 3: Coverage Index

步骤3:覆盖索引

Generate a Coverage Index file using the template in
assets/coverage-index-template.md
.
List every Feature ID with initial status
Planned
.
使用
assets/coverage-index-template.md
中的模板生成覆盖索引文件。
列出每个Feature ID,初始状态设为
Planned

Reference

参考资料

See
references/naming-conventions.md
for ID format details.
有关ID格式的详细信息,请参阅
references/naming-conventions.md