aisdlc-project-discover-level1-index-skeleton

📁 zixun-github/aisdlc 📅 2 days ago
3
总安装量
3
周安装量
#56042
全站排名
安装命令
npx skills add https://github.com/zixun-github/aisdlc --skill aisdlc-project-discover-level1-index-skeleton

Agent 安装分布

cursor 3
claude-code 3
mcpjam 1
kilo 1
windsurf 1
zencoder 1

Skill 文档

aisdlc-project-discover-level1-index-skeleton(Step3:索引骨架 + 进度面板)

概览

索引页的唯一职责是:导航 + 进度。细节一律落在模块页/契约入口页/ops 页。

开始时宣布:「我正在使用 aisdlc-project-discover-level1-index-skeleton 技能生成地图层索引骨架与复选框进度面板。」

输出文件(骨架)

  • .aisdlc/project/components/index.md
  • .aisdlc/project/products/index.md(可选)
  • .aisdlc/project/contracts/index.md
  • .aisdlc/project/contracts/api/index.md
  • .aisdlc/project/contracts/data/index.md

写法约束(硬规则)

  • index.md 只做导航:表格 + 链接 + 状态复选框;禁止复制模块细节。
  • 用复选框管理补齐进度:
    • - [ ] moduleA:未达标
    • - [x] moduleA:达到对应优先级 DoD

最小模板(可复制)

components/index.md

module priority owner code_entry api_contract data_contract ops_entry status
P0/P1/P2 <path> ../contracts/api/<module>.md ../contracts/data/<module>.md ../ops/... – [ ]

contracts/index.md

  • API:./api/index.md
  • Data:./data/index.md

contracts/api/index.md

module authority_entry invariants evidence status
<openapi/proto path> 3–7 条摘要 code/test/ci 入口 – [ ]

contracts/data/index.md

module ownership authority_entry invariants evidence status
主写/只读/同步 <schema/migrations path> 3–7 条摘要 code/test/ci 入口 – [ ]

products/index.md(可选)

product_module owner key_components key_data_ownership status
../components/... ../contracts/data/... – [ ]

常见错误

  • 索引写成模块页:越写越长,维护爆炸;应只保留链接与极短摘要。
  • 没有 checkbox 进度:会失去“先骨架后补证据”的迭代机制。

红旗清单(出现任一条:停止并纠正)

  • 在索引里出现接口字段说明/表字段字典/详细时序/操作手册
  • 为了“看起来完整”把模块页内容复制到 index
  • 没有明确 P0/P1/P2 却开始写大量模块细节