| name | sillyspec:doctor |
| description | 用于 SillySpec 自检和状态修复。适合用户说"检查下状态、修复 progress、doctor、状态不对"。全量扫描进度一致性,修复进度数据与实际产出不匹配的问题。 |
何时使用
- 用户说"检查下状态、修复 progress、doctor、状态不对"
- 进度数据与实际产出不匹配时自检修复
- 5 步:环境检查 → 项目配置 → 数据库完整性 → 状态一致性 → 修复建议
前置检查
执行任何步骤前,先确认 SillySpec CLI 可用:
sillyspec --version
失败则提示 ❌ SillySpec CLI 未安装 + 安装命令 npm install -g sillyspec,停止。
步骤生命周期(所有阶段通用)
sillyspec doctor 是 sillyspec run doctor 的顶层别名,两者等价。
sillyspec run doctor
sillyspec run doctor --done --output "摘要"
sillyspec run doctor --status
sillyspec run doctor --reset
通用参数(所有阶段适用)
| 参数 | 说明 |
|---|
--spec-dir <path> | 指定规范目录(默认 <项目>/.sillyspec) |
--non-interactive | CI/脚本下禁用交互式 prompt |
--json | 输出 JSON(程序化读取) |
doctor 特有
doctor 是辅助阶段,用于诊断而非推进流程。配套的轻量诊断命令(不经 run):
sillyspec progress show
sillyspec progress check
sillyspec progress repair
sillyspec progress repair --apply
sillyspec progress validate
sillyspec worktree doctor [--fix]
sillyspec doctor --align-execute-progress --change <name>
sillyspec doctor --align-execute-progress --change <name> --confirm
--align-execute-progress 仅当 plan.md 所有 task checkbox 全勾时才对齐 execute 阶段进度戳。典型用于 worktree 已 cleanup(终态)但 execute 派生戳未盖上的死锁。默认 dry-run,加 --confirm 才写盘。doctor 信任 plan.md 声明、不复核代码,verify 阶段兜底。--change 缺省时按单活跃变更自动兜底。
铁律
- 必须用 exec 工具(shell)执行 CLI,不要自己编造流程
- doctor 只诊断和建议,修复操作要让用户确认
- 完成后立即
--done,不跳过
用户指令
$ARGUMENTS