用途:Knowledge Graph(KG)是一个持久化 JSON 文件,存储代码库分析发现,避免重复探索,并支持任务校验。文件位置为 docs/specs/[ID-feature]/knowledge-graph.json。
主要能力:提供七种操作。read-knowledge-graph 加载并解析指定规格的 KG;query-knowledge-graph 按组件、模式、API 等分区查询并过滤;update-knowledge-graph 合并新发现;validate-against-knowledge-graph 校验任务依赖;validate-contract 校验任务间 provides/expects;extract-provides 从已实现文件提取符号;aggregate-knowledge-graphs 合并所有规格的模式为全局 KG。
使用方式:通过触发短语调用,如“Load knowledge graph”“Query knowledge graph”“Update knowledge graph”“Validate against knowledge graph”“Check if component exists”“Find existing patterns”。示例命令:/knowledge-graph read docs/specs/001-hotel-search/;/knowledge-graph query docs/specs/001-hotel-search/ components {"category": "services"};/knowledge-graph update docs/specs/001-hotel-search/ {...};/knowledge-graph validate docs/specs/001-hotel-search/ {"components": ["comp-repo-001"]}。
适用场景:spec-to-tasks 缓存或复用代码库分析;task-implementation 校验依赖与契约;任何命令查询已有模式、组件或 API;减少重复代码库探索。
限制:不修改源代码,仅创建或更新 knowledge-graph.json;仅读写 docs/specs/[ID]/ 路径下的 KG 文件;不自动生成实现代码。校验范围依赖 KG 新鲜度,无法确认实际代码库中是否存在;KG 准确性取决于更新及时性;每个 KG 主要针对单一规格;复杂规格的 KG 文件可能超过 1MB。新鲜度参考:小于 7 天为新鲜,7 至 30 天为陈旧并警告用户,超过 30 天为非常陈旧并建议重新生成。