hoangnb24/repository-harness

解决的问题

代码代理常常因缺乏明确意图、缺少权威文档，以及在面对模糊情况时倾向于自行发明产品策略而陷入困境。repository-harness 通过将软件仓库转化为结构化、代理就绪的工作区，强调基于证据的变更和明确的决策边界，解决了这一问题。

工作原理

该工具将仓库协议和安全更新器安装到目标项目中。它建立了一组核心文件——包括一个紧凑的 AGENTS.md 入口点、文档地图，以及产品决策和执行计划的结构——以引导代理。它定义了特定的请求工作流：只读请求以证据作答，有限变更需附带证明实施，复杂变更则要求在 docs/plans/active/ 中提供持久的计划。

适用人群

使用 AI 代码代理并希望确保代理遵循仓库的权威文档、避免推测性策略的创造，并保持决策与进展的持久记录的开发者。

特色亮点

• 代理就绪结构： 提供紧凑的入口点和可导航的地图，帮助代理理解仓库。
• 安全维护： 包含版本化的二进制更新器，使用三向合并保留本地修改，并以事务方式处理冲突。
• 明确的决策边界： 当存在模糊性时，强制代理在进行重大产品变更前停止。
• 不变性强制： 提供可选技能，用于编码不变性，并支持对已有仓库（brownfield repositories）进行显式接入。