hoangnb24/repository-harness

解决的问题

编码智能体经常由于缺乏明确的约束、模糊的权威文档以及长期任务中的进度丢失而失败。repository-harness 通过将软件仓库转换为结构化的、智能体就绪的工作区来解决这些问题，其中仓库本身作为记录系统（system of record）而非外部数据库发挥作用。

工作原理

它在项目中安装一套标准化的文档文件和脚本。这为智能体创建了一个小型且稳定的入口点（通过 AGENTS.md），以及一个位于 docs/ 目录下的权威知识图谱（例如架构、工作流和产品行为）。对于复杂任务，它实现了一个持久的执行计划系统，其中进度和决策记录在 Git 跟踪的 Markdown 文件中。它还强调通过仓库原生的测试进行机械验证。

适用对象

使用 AI 编码智能体来维护和演进代码库的软件工程师和团队，他们希望确保智能体拥有正确的上下文并遵循架构规则，而无需依赖繁重的强制性工作流。

亮点

• 智能体就绪的入口点：使用紧凑的 AGENTS.md 来减少指令加载和漂移。
• 持久的执行计划：提供一个在 docs/plans/ 中跟踪多会话或重度协作变更的系统。
• 仓库即真理：将所有产品行为、决策和计划保留在仓库中，实现完全的可审计性。
• 机械验证：专注于通过行为和测试来证明完成情况，而不是进行账目记录。
• 入职工具：包含 $onboard-repository 技能，帮助智能体映射现有（brownfield）仓库。