phase-5-validator

phase-5-validator 是一个关键的自动化工具，旨在作为软件开发工作流程结束前的最后一道质量关卡。它针对资深开发人员、DevOps 工程师和自动化代理，确保所有项目产出物符合既定的组织标准。通过执行一系列程序化检查，该工具可防止不完整的文件、未提交的代码或未解决的技术债进入交付阶段。它具有阻断权限，这意味着任何违反强制检查清单的行为都将阻止工作流程被标记为完成。

• 执行强制性的单一真相来源验证，以确保各个技能与文档之间不存在 bash、程序或自动化重复。

• 对“经验教训”(lessons learned) 文档实施严格的文件大小限制，以维护仓库健康并防止技术债积累。

• 验证版本控制完整性，检查未提交的 git 变更、提交信息标准、分支同步状态以及是否有合并冲突。

• 审核文档完整性，确保文件注册表已更新、PROGRESS.md 是最新的、功能文档详尽无遗，且 CLAUDE.md 得到维护。

• 通过检查测试套件是否通过、是否存在阻碍性问题以及是否有部署说明，来验证部署就绪状态。

• 通过识别暂存文件、工作区目录和孤立的项目资产来自动化清理仓库。

• 退出代码 0 表示最终确认成功，退出代码 1 则表示存在阻碍性违规或质量门槛未通过。

• 对于所有功能开发周期皆为强制性，以确保垂直切片架构的合规性与文档的一致性。

• 当验证失败时，代理必须检查日志，解决特定的阻碍性违规（例如文件大小、未提交的变更），然后重新执行验证器。

• 与 WitchCityRope 代理生态系统直接整合，在所有开发阶段提供一致且可重复的成果。

• 要求开发人员维护文件注册表、更新部署说明并遵守标准的提交格式，以确保自动化验证的成功。