aisdlc-project-discover-scope
aisdlc-project-discover-scope(Step1:范围止损与模块分级)
概览
Discover 的最大风险不是“写得不够”,而是“试图覆盖所有模块导致不可维护”。Scope 的任务是先把范围收敛,并对不同优先级规定最低交付深度。
开始时宣布:「我正在使用 aisdlc-project-discover-scope 技能对模块做 P0/P1/P2 分级并设置逆向深度门禁。」
分级规则(建议)
- P0(必须逆向):高频变更、跨团队交界、对外集成多、事故热点、合规风险高
- P1(建议逆向):稳定但高频被引用/被问到/被依赖的基础能力
- P2(按需逆向):低风险、低协作、生命周期短;只保留索引占位与入口
深度门禁(强约束)
- P0 必须同时具备
.aisdlc/project/components/{module}.md.aisdlc/project/contracts/api/{module}.md.aisdlc/project/contracts/data/{module}.md- 证据入口(代码/测试/CI/ops)
- P1 必须具备
.aisdlc/project/components/{module}.md- 至少一个契约入口页(API 或 Data)
- P2 只要求
- 在索引占位(
components/index.md;如有 products 也占位) - 保留入口链接即可(没有入口就写“未发现”)
- 在索引占位(
Scope 输出怎么写(放到索引里)
在 .aisdlc/project/components/index.md 的表格里体现分级与进度(索引只导航,不写细节):
| module | priority | owner | code_entry | api_contract | data_contract | ops_entry | status |
|---|---|---|---|---|---|---|---|
| user | P0 | TeamA | path/... |
contracts/api/user.md |
contracts/data/user.md |
ops/... |
- [ ] |
status用复选框:- [ ]未达标;- [x]达到对应优先级的 DoD。
常见错误
- 把 P0/P1/P2 当“写作优先级”:正确含义是“交付深度门禁不同”。
- P0 只写组件页,不写契约入口页:这会导致后续对接/改动无法追溯“承诺边界”。
- P2 也写成详尽模块页:范围会失控,维护失败。
红旗清单(出现任一条:停止并纠正)
- “全模块都要写到字段级”或“先把细节写全”
- 还没完成 P0,就开始铺开 P1/P2 的细节
- 不能明确 P0 模块是谁/边界是什么,却已经开始写大量流程细节
More from zixun-github/aisdlc
spec-product-prd
Use when 需要在 sdlc-dev 的产品需求 Spec 流程执行 R2,将 requirements/solution.md 转写为可交付、可验收、可测试的 requirements/prd.md,且需要避免猜路径、在缺少 solution.md 时仍继续生成、或用“待确认问题/Open Questions”替代验证清单。
126subagent-driven-development
Use when executing implementation plans with independent tasks in the current session
109spec-product-demo
Use when 需要在 sdlc-dev 的产品需求 Spec 流程执行 R4(基于 requirements/prototype.md 生成可交互 Demo 工程),并需要避免跳过 spec-context、在缺少 prototype.md 或缺少可运行 Demo 工程根目录时仍继续、或自创页面/目录导致不可追溯与无法回流闭环。
109spec-design
Use when 需要为某个 Spec Pack 产出 D2 决策文档(RFC/Decision Doc),且必须强制消费项目知识库与 `{FEATURE_DIR}/requirements/solution.md#impact-analysis`;适用于在时间/权威压力下容易只读索引、跳过受影响模块/ADR 全文、静默忽略缺失输入或不写 `CONTEXT GAP`、以及遗漏“与现有系统对齐”自检的情况。
104finishing-development
用于确认开发已完成,并确保所有测试/检查全部通过
101project-discover-memory-index
Use when 你已经确定了 Discover 的范围(P0/P1/P2),现在需要快速建立 `.aisdlc/project/` 的 Level-0 北极星(memory)与 Level-1 地图层索引骨架(components/products),以便后续按模块补证据而不发生双写与漂移。
91