用途:specs-kit-sync 是 SDD(规格驱动开发)流程中的收尾步骤,保持规格(WHAT)、任务与验收标准(验证)、实际代码(HOW)三者同步,解决技术上下文不一致、规格与任务不对齐、代码库图过期、规格与代码漂移四类问题。
主要能力:全量同步(刷新图→差距分析→任务充实→漂移检测→规格更新,阶段 1-9);仅图模式(--kg-only,刷新代码库图并充实任务);仅代码模式(--code-only,检测规格到代码漂移并更新规格);--after-task=TASK-003 将分析收窄到特定任务之后的改动。核心原则包括增量更新、以 graphify-out/graph.json 为唯一图来源、以实际实现为准、非破坏性保留人工批注、可追溯、幂等、规格反映系统实际行为。
使用方式:/skill:specs-kit-sync docs/specs/001-feature/;带 --after-task、--kg-only 或 --code-only 参数。运行前先检查 /graphify 技能是否安装,并确认 graphify-out/graph.json 是否存在;缺失时会重跑 /graphify <project-root> 一次生成。
限制:graphify 为硬依赖,缺失时同步仍会执行但结果标记为 partial,跳过基于图的校验;不得手工编辑或替换 graph.json,刷新必须通过重跑 graphify 完成。资料未提供收费、价格、平台要求等信息。