罗斯蒙德需求拆解任务

概述

把需求材料拆成研发能直接排期、能直接建卡的任务清单。

一、适用场景

二、痛点与解法

三、工作流程

需求材料（文档/纪要/接口说明）
        ↓  AI 阅读理解（本步由模型完成）
   ir.json（结构化任务拆解 IR）
        ↓  check_breakdown.py  校验与反查
   核验报告 + 修正
        ↓  render_doc.py / export_cards.py
   Markdown 文档 + 建卡 CSV/JSON

第 1 步 · 读取材料PDF/Word 等二进制材料由你（模型）先提取正文，落盘为 .txt，再连同 IR 一起交给脚本做风险与配套反查。脚本只吃文本，不解析二进制。

第 2 步 · 填写 IR按 templates/task_ir_template.json 产出 ir.json。七段式：meta / summary / impact_scope / tasks / risks / open_questions / acceptance。字段口径见 references/task_schema.json。

关键纪律：

• summary.problem 用研发视角写，≥20 字；必须写 non_goal，否则范围会蔓延。
• 任务标题以动作开头（新增/改造/接入/编写/验证/执行/制定…）。
• 每条任务必填 deliverable；mitigation 不得写「注意」「后续」这类空话。
• estimate_days 取 0.5–5，步长 0.5。
• 依赖用 depends_on 表达，不得成环；互不阻塞的标 parallelizable: true。

第 3 步 · 校验

python scripts/check_breakdown.py --ir ir.json --source 需求原文.txt 
    --report 核验报告.md --stats stats.json

有 ERROR 即退出码 1，按报告逐条修正后重跑，直到 ERROR 0。

第 4 步 · 出文档与建卡

python scripts/render_doc.py   --ir ir.json --output 任务拆解.md
python scripts/export_cards.py --ir ir.json --csv 建卡.csv --json 建卡.json

第 5 步 · 评审核验报告.md 里的「未覆盖的配套工作」与「待确认问题（阻塞项）」是评审会的议程清单。

四、输出规范

五、校验器拦什么（26 项断言已覆盖）

六、验收标准对照

七、知识库（改规则不改代码）

八、使用纪律

1. 不编造：任务、影响范围、风险必须能从输入材料推出；材料没提到的模块不要凭空列进影响范围。
2. 不确定就进待确认：凡是影响方案选择但材料没写清的（灰度维度、数据量级、密钥来源、是否迁移存量），一律进 open_questions 并标 blocking，而不是替业务方拍板。
3. 非目标必写：non_goal 是防止评审时范围蔓延最有效的一栏，材料没写就按方案边界推断并标注。
4. 风险要写缓解措施：只写「需注意」会被校验器判 ERROR——写不出缓解措施说明这条风险还没想清楚。
5. 人日是粗估不是承诺：输出的是相对量级，用于排期比较，实际工时以承接人评估为准。

九、已知限制

• 需求理解依赖模型：脚本只做结构化校验，不校验「拆得对不对」。业务判断错误、模块归属错误，校验器发现不了。
• 覆盖度是清单级而非语义级：能查出「没有测试任务」「没提监控」，但查不出「测试任务写得对不对」。
• 人日估算为经验粗估：不含联调等待、评审返工、环境搭建等隐性成本，排期时建议按团队历史系数放大。
• 影响范围靠材料推断：若材料未提及某模块，不会凭空补全；这类盲区应通过 open_questions 显式提出。
• 示例为单一需求样本：examples/ 里的文档加解密案例仅演示结构与深度，不代表所有需求类型。
• 无在线协同能力：不写入 Jira/Tapd/禅道，只产出可导入的 CSV/JSON，导入动作需人工执行。

十、快速开始

# 1. 用模板产出 ir.json（由模型填写）
# 2. 校验
python scripts/check_breakdown.py --ir ir.json --source 需求原文.txt --report 核验报告.md
# 3. 出文档与建卡
python scripts/render_doc.py   --ir ir.json --output 任务拆解.md
python scripts/export_cards.py --ir ir.json --csv 建卡.csv --json 建卡.json
# 4. 一键验证本技能自身
python test/run_all.py