用途：帮助用户同步 .spec-driven/roadmap/ 与当前变更历史，让路线图的规划状态与仓库实际证据保持一致。
主要能力：先读取 .spec-driven/config.yaml、.spec-driven/roadmap/INDEX.md 及索引中列出的所有里程碑文件，并运行 roadmap-status 获取确定性的里程碑与计划变更状态摘要；随后对比路线图与仓库现实，识别已归档的计划变更、仍活跃的计划变更、缺失或已改名的计划变更，以及不再匹配的里程碑状态和脚本无法解决的歧义（如疑似改名、仍需人工判断的路线图描述）；最后依据证据更新里程碑状态及每个计划变更的声明状态。
必要用法：需在项目根目录存在 .spec-driven/ 目录，可先用 ls .spec-driven/ 验证；若未初始化，先运行 /spec-driven-init；若缺少 .spec-driven/roadmap/，先执行 node {{SKILL_DIR}}/scripts/spec-driven.js init 修复脚手架。可用命令还包括 roadmap-status 与 verify-roadmap，命令形式为 node {{SKILL_DIR}}/scripts/spec-driven.js <subcommand>。完成前运行 verify-roadmap 校验路线图大小，若某里程碑过大应停止并提示拆分。
合法状态值：里程碑为 proposed、active、blocked、complete；计划变更为 planned、complete。同步时须遵守规则：仅当所有列出的计划变更均已归档才能将里程碑标记为 complete；路线图保持为规划状态而非实现日志；不保留与实际归档状态冲突的过时人工标签；当路线图条目不再匹配任何变更时须明确暴露歧义。
限制：该技能仅用于规划与文档，不修改产品代码；确定性状态比较以 roadmap-status 与路线图文件为准；涉及改名等无法自动判定的情况需人工清理。其余收费、平台等信息资料未提供。