repository-harness

收录理由

Claude Code、Codex、Cursor 这类编程代理在真实仓库里常常迷失方向，因为改动背后的意图只存在于聊天记录中，仓库里没有任何文件指明哪些是权威文档。这个项目给代码库装上一套轻量协议，让代理能读懂工程脉络：一个精简的 AGENTS.md 入口、一份可浏览的文档地图、只在改动跨会话时才生成的持久计划，以及明确的判断边界，让代理在需要自行编造产品策略之前停下来。对于改个错别字这种小事，它不会添乱；但对于长周期或需求模糊的改动，它会强制建立结构。它的安全更新器用三方合并处理受管文件，遇到冲突先暂存而不是直接覆盖本地修改。团队如果希望多个仓库里的代理行为保持一致，会喜欢它的安装脚本和带版本号的 harness 二进制；显式授权式的上手流程和不变式技能，也把代理何时动手的控制权牢牢握在开发者手里。