用途:spec-index 只做“派生辅助文件”的组装,从 docs/specs/{Bucket}/ 下既有的 8 节 Feature Spec 中读取 §1 概述、§5 领域模型 Mermaid、§8 测试用例,生成可重新生成的导航层,避免出现第二份手工维护的真相来源。它不撰写业务内容。
主要能力:默认生成 {Bucket}/INDEX.md 功能目录(能力名、摘要、Feature Code、TC 数量、状态);按请求生成跨能力 ERD({Bucket}.erd.md);按显式请求生成重实现指南({Bucket}.reimplementation-guide.md)。另有 audit 模式,对比源 spec 与派生文件时间,报告哪些派生文件已过期。
使用方式:先执行 Step 0 范围门,向用户确认 Bucket、模式(index/audit)与产物;若目标 bucket 没有 docs/specs/{Bucket}/README.*.md 形式的 Feature Spec,则停止并转交 $spec。随后读取源 spec 提取字段,组装产物,写入时每个文件都带 > DERIVED — regenerate via $spec-index; do NOT hand-edit 横幅与日期,最后自检链接、横幅与禁用产物。
限制:禁止生成已废弃的 A-E 工程树、M## 目录、00-module-registry.md、01-domain-erd.md、06-reimplementation-guide.md、docs/specs/README.md、PRIORITY-INDEX.md 等;INDEX/ERD 正文保持技术无关,只有重实现指南可指定目标技术栈;每行目录与 ERD 实体需回链源 spec,无法确认时标 [UNVERIFIED]。具体命令、项目路径与 bucket 映射以仓库文档为准,资料未提供完整细节。