用途:该技能定义了一套规范化的文档制品类型、生命周期阶段与层级关系,用于在仓库中创建、校验和流转各类规格文档。制品类型包括 Vision、Journey、Epic、Story、Agent Spec、Spike、ADR、Persona、Runbook、Bug、Design,以及由 Spec 派生的实现计划。
主要能力:定义制品间关系模型,区分强制层级(如 Vision 到 Epic、Epic 到 Spec/Story)与信息性交叉引用(如 ADR、Persona、Design 的关联)。每个制品内嵌生命周期表,记录阶段、日期与提交哈希。每个类型目录维护 list-<type>.md 索引,创建、编辑、流转或废弃后都需刷新。
脚本工具:scripts/specwatch.sh 监控 docs/ 中的过期引用,检查 Markdown 链接路径与 frontmatter 引用字段,支持 scan、watch、stop、status、touch 子命令,结果写入 .agents/specwatch.log。scripts/specgraph.sh 构建并查询依赖图,支持 overview、build、blocks、blocked-by、tree、ready、next、mermaid、status 子命令。
使用方式:创建制品时先扫描目录确定编号,读取对应定义与模板,放入正确阶段子目录,填充 frontmatter 并初始化生命周期表,校验父引用存在,最后刷新索引。每次制品操作后运行 scripts/specwatch.sh scan。阶段流转前运行 blocks <ID> 检查依赖。审计时并行启动多个子代理分别检查生命周期、交叉引用、命名结构、阶段目录对齐与依赖一致性。
适用场景:适合需要以文档驱动方式管理产品愿景、需求、架构决策与运行手册的仓库,尤其适合单人工作流中允许跳过中间阶段的场景。
限制:背景 watch 模式需要 fswatch;scan 仅依赖 Python 3 与文件系统。资料未提供安装命令、收费信息或具体平台支持范围。