woostack-doctor

woostack-doctor

诊断仓库 .woostack/ 工作区的健康状况，并在获得明确批准后进行修复。Doctor 用于本地完整性和约定检查；它不会创建工作区、发布规划产物、协调功能看板，也不会修复远程资源。

它分为两个层面：

• 无头模式的 scripts/doctor.sh 引擎不依赖任何提供方。所有检查均为静态检查：不读取凭据，也不进行网络调用。
• 交互式修复层会提出本地变更集，获批前不会修改任何内容。仅在此工作流的限制范围内，应用明确批准的本地修复，并使用随附的实现模式和验证流程。远程数据和保留数据仅作报告，不作修改。

命令

• /woostack-doctor [path] — 诊断工作区，然后针对能够描述的本地问题，提供一份需经授权的变更集。
• /woostack-doctor [path] --check — 仅进行诊断，打印 GitHub 风格的注释；存在 error 级别的问题，或检查未能完成时，以非零状态退出。不会修改任何内容。

引擎使用本地随附的模板和规范配置解析器。无需其他 Woostack 技能或源代码检出。

流程

1. 在工作流接纳目标路径之前，记录用户指定的目标；不得对其执行 stat、读取、规范化或调用 Git。
2. 通过相对于此已安装技能的 scripts/config/resolve-config.sh，解析有效的跟踪策略与主检出本地策略。Doctor 使用此权威验证结果；不会重复实现 GitHub schema。
3. 对配置、诊断、忽略规则偏差和保留数据执行静态只读检查。OMP Agent 的选择由宿主负责；Doctor 绝不检查、创建、修复或移除项目 Agent 定义。旧版提供方设置和镜像时代的清单会予以保留，且只提供可执行的弃用指导；它们绝不会选择目标位置、重建包装器，或阻碍无关的本地诊断。
4. 如果不存在 .woostack/，则停止并报告需要显式初始化本地支持。单独请求的初始化工作流只是可选的导航方式，并非安装前提或自动移交。Doctor 绝不搭建脚手架。
5. 按问题代码、路径和具体本地变更对变更集进行分组并提出建议。问题可以描述修复方案；但任何检查都不会自行应用修复。
6. 硬性门槛——批准。 沉默不代表批准。批准编辑本地文件，不代表授权提交、推送或创建 PR。核实工作区归属，保留无关工作，并且只应用获批的本地变更集。在最终验证及任何要求的独立审查之前，根据随附的最少代码指南，进行一轮范围明确且保留行为的简化；结果未发生变化也有效。按照随附的验证流程运行受影响的检查。任何必需检查失败都会阻止交付。只有在明确要求提交或交付 PR 时，才使用交付流程，并遵守仅限本地或仅限提交的限制。任何辅助命令都不会联系提供方或修改保留数据。
7. 使用相同的静态模式确认状态，并报告剩余问题。

硬性约束

• 缺少配置是有效状态；未设置 github 表示未选择 Project/Status 策略。
• 打包的解析器只验证一次规范的顶层 github 对象。旧版 artifacts.provider、artifacts.linear、artifacts.plane 和较早的根级提供方设置 都是历史数据，不透明处理：予以保留，不将其作为有效策略进行验证，并在受影响的边界说明其已弃用。
• 静态诊断不依赖提供方。授权的 GitHub 能力证据由调用工作流通过原生宿主工具或经过宿主身份验证的 gh 读取；Doctor 不接受能力回执，也绝不打开提供方会话。
• 绝不搭建脚手架、迁移、导入、镜像、创建、修复、重新挂接、重写、关闭或删除远程记录或保留的记录。绝不读取凭据，也不调用自定义 HTTP/GraphQL 传输。
• 每项修复都必须经过审批。保留符号链接/禁止跟随、私有文件、锁定/CAS、工作树未提交更改和回读安全机制。绝不合并。
• 诊断引擎绝不写入 .woostack/ 支持文件；只有明确获批的交互式修复，才可在其选定的变更集中写入此类文件。Doctor 绝不检查、清理或移除 Git 工作树注册信息。工作区生命周期由宿主或仓库所有者根据工作区指南管理。