hoangnb24/repository-harness

它解决了什么问题

编码代理常因缺乏明确意图、缺少权威文档，以及在长期变更中失去决策上下文而陷入困境。repository-harness 通过将软件仓库转换为结构化、代理就绪的工作区来解决这些问题，并将仓库视为产品文档、代码与决策的唯一真实来源。

运作方式

它会在目标项目中安装仓库协议与安全更新器二进制文件。此设置为代理提供精简的入口点（AGENTS.md）、可导航的仓库地图，以及用于持久计划与决策的模板。它避免安装应用程序特定的架构或编排，而是提供一组仅限显式执行的技能，用于探索、审计与不变量编码，这些技能仅在明确要求时才会执行。

适用对象

使用 AI 编码代理的开发者，希望确保这些代理拥有与人类工程师在仓库中相同的上下文、限制与权威指导。

重点

• 代理就绪结构： 为 AI 代理提供标准化的入口点与导航地图。
• 安全维护： 包含一个通过三方合并处理更新的二进制文件，以保留本地编辑并以事务方式管理冲突。
• 显式执行： 用于仓库入门与不变量强制的技能为只读或仅限显式执行，防止代理自行发明产品政策。
• 仓库中心： 将产品意图与理由保存在仓库本身，而非外部任务数据库或聊天记录中。