Project State Governor 是一个项目状态与文档治理技能,定位为项目状态与文档的治理者,而非产品负责人、编码代理、研究执行者或发布审批者。其使命是维护项目持久且有证据支撑的权威状态,使新进入对话的代理能快速判断项目存在的原因、当前权威内容、活跃/阻塞/延期/完成事项、失败且不应重复的路径、约束未来工作的决策与限制,以及下一步应做什么。
适用场景:在对话、代理或分支切换后恢复大型项目;计划、状态文件、评审、测试与实现证据相互矛盾;完成声明在成为持久项目状态前需要验证;昂贵的负面证据或重复教训需要跨会话保留;碎片化项目文档需要有限度整合。不适用于替代实现、领域研究、产品所有权或发布审批。
核心模型:Git 保存历史,权威项目状态系统保存当前持久知识,AGENTS.md 定义代理如何运作,对话历史只是工作上下文而非权威项目记忆。提供紧凑模式(AGENTS.md + PROJECT_STATE.md)与扩展模式(.project/ 下 MANIFEST.md、STATE.md、DECISIONS.md、CONSTRAINTS.md、NEGATIVE_EVIDENCE.md 及 areas/ 子文件),多个文件共同构成一个权威状态系统。
关键机制包括:权威层级排序、意图分类(MISSION、SUCCESS_CRITERION、WORKSTREAM、MILESTONE、TASK、RESEARCH_HYPOTHESIS、DECISION、CONSTRAINT、BLOCKER、DEFERRED、QUESTION、LESSON)、分层完成定义(SESSION_DOD、TASK_DOD、MILESTONE_DOD、WORKSTREAM_DOD、MISSION_SUCCESS)、语义状态差异、持久化生命周期(RECALL -> PROPOSE -> VERIFY -> APPLY -> CONSOLIDATE)、来源与置信度标注(CONFIRMED、INFERRED、UNKNOWN)、状态转换、完成声明验证、分支与证据卫生、与其他治理者的协调、所有者权限边界、仓库重建模式,以及状态更新等式 OLD_STATE + VERIFIED_NEW_FACTS - INVALIDATED_FACTS = NEW_STATE。
限制:无法确定未定义的业务意图或在合法所有者决策中做选择;需要访问相关项目证据,无支撑结论保持 UNKNOWN;不替代工程、安全或领域验证流程;被授权时可修改权威文档,因此大范围清理或删除须先暂存并评审。具体安装命令、平台、收费与价格暂未提供。