用途:帮助用户管理手动维护工作流,即按仓库显式配置的检查项运行维护,并可在需要时查看或调整配置。前置条件是目标项目根目录已含 .spec-driven/,否则先运行 /spec-driven-init。
主要能力:读取 .spec-driven/maintenance/config.json 及仓库 README 或项目文档中定义的 lint、测试、类型检查命令;手动触发维护;对配置中允许的确定性、低风险问题执行自动修复;将成功的维护变更归档,并处理维护分支、提交与分支恢复。
使用方式:检查前置条件用 ls .spec-driven/;手动运行维护用 node {{SKILL_DIR}}/scripts/spec-driven.js run-maintenance [path]。之后需报告运行结果:因配置缺失或无效而失败、因仓库脏、无配置检查或已有活动维护变更而跳过、所有检查已通过而干净完成、发现无法修复的失败、在修复/归档/提交/恢复分支时被阻塞,或已创建维护分支并修复检查。调整配置时只保留仓库明确支持的检查命令,仅为确定性低风险修复添加 fixCommand,仅在需要自定义命名时使用 changePrefix、branchPrefix、commitMessagePrefix。
限制:不要为语义含糊的测试失败添加推测性的 fixCommand;维护配置是允许修复的唯一依据;若运行留下被阻塞的变更,应如实报告,不能假设修复成功。具体命令执行细节因资料有限暂未提供。