| name | nexus-investigator-feature-step-plan |
| description | 该 skill 定义了 Investigator 产出复杂功能步骤文档时的正文结构、成熟度要求与判断标准。 |
何时使用
仅当契约要求:
Requested Research Artifact: Feature Step Plan
产物目标
功能级步骤文档负责:
- 把复杂功能拆成可独立实现、评审、提交的顺序步骤
- 明确每一步的输入、输出、完成信号、风险
- 若涉及 UI,UI 必须位于最后一步
输出到:
何时必须产出步骤文档
满足以下任一情况时,应产出步骤文档,而不是只停留在功能级预研:
- 涉及超过 3 个模块
- 依赖链明确且存在先后顺序
- 无法安全一次性实现
- 同时包含接口 / 状态 / UI 多层联动
- 存在“逻辑先完成、UI 最后收口”的明显阶段关系
- 一次性交给
Generalist 实现会导致范围过大或 review 风险过高
功能级步骤文档的合格标准
一份合格的步骤文档必须满足:
Nexus 能据此按步创建 todo 和流程
Generalist 能明确当前只实现哪一步
Reviewer 知道每一步该验什么
- 每一步都具有明确完成信号
- UI 不会被错误提前
- 功能整体可按步骤闭环,而不是依赖最后一次大爆炸集成
每一步必须写清的内容
当你写功能步骤文档时,每一步必须至少包含:
- Step ID / Step Name
- Step Goal
- Why This Step Exists
- Modules Involved
- Depends On
- Inputs Required
- Outputs Produced
- 是否会新增外部接口
- 是否会新增外部字段
- Done Signal
- Reviewer Focus
- Risks
- Can Commit Independently: Yes / No
- Next Step Dependency
UI 步骤规则
若功能涉及 UI:
- UI 必须单独成为最后一步
- 必须明确 UI 步骤依赖:
- 哪些上游接口
- 哪些字段
- 哪些状态
- 哪些错误 / 空状态语义
- 必须说明为什么不能提前做 UI
正文模板
功能级步骤文档
正文至少包含:
- Title
- Research Type: Feature Step Plan
- Parent Feature Scheme
- Scope / Non-Goals
- Fact Sources
- Overall Step Strategy
- Step Order Rationale
- Step List
- For each Step:
- Step ID / Step Name
- Goal
- Why This Step Exists
- Modules
- Depends On
- Inputs Required
- Outputs Produced
- External Interface / Field Impact
- Done Signal
- Reviewer Focus
- Risks
- Independent Commit: Yes / No
- Next Step Dependency
- UI Step Placement
- Regression Concerns
- Step Validation Notes
- Final Integration Notes