用途:诊断仓库本地 .woostack/ 工作区的完整性与约定合规性,并可在明确批准后提出本地修复变更。它不创建或发布工作区、不协调功能板、不修复远程资源。
主要能力与用法:
- 无头脚本 scripts/doctor.sh 引擎与提供方无关,所有检查均为静态:不读取凭据、不发起网络请求。
- 交互式修复层先提出本地变更集,在批准前不发生任何改动。明确批准的修复需经 woostack-execute 处理,附带批准范围与提交/发布限制,本地变更需标注不提交、不推送、不开 PR。
- 命令:/woostack-doctor [path] 诊断工作区并给出受限的本地修复变更集;/woostack-doctor [path] --check 仅诊断,输出 GitHub 风格注解,发现错误或检查无法完成时以非零退出,不做任何改动。
- 通过 woostack-init/scripts/config/resolve-config.sh 解析生效的本地策略,规范 github 对象由 Init 解析器校验一次。
限制:缺少配置是有效的;没有 github 表示未选择 Project/Status 策略。旧版 artifacts.provider、artifacts.linear、artifacts.plane 及更早的根提供方设置属于历史数据,仅保留并给出退役建议,不作为有效策略校验。静态诊断与提供方无关;不读取凭据、不开启提供方会话、不调用自定义 HTTP/GraphQL 传输。永不脚手架、迁移、导入、镜像、创建、修复、重设父级、改写、关闭或删除远程及保留记录。每次修复都需批准;静默不算批准。不写入 .woostack/ 支持文件,不检查、清理或移除 Git worktree 注册。无 .woostack/ 时停止并指向 woostack-init 的本地支持路径(仅用于支持初始化,不做文档访谈)。缺少明确资料的部分暂未提供。