repository-harness如何将任何代码仓库转变为AI代理就绪工作区完整指南【免费下载链接】repository-harnessTurn any repo into an agent-ready workspace for Claude Code, Codex, Cursor, and other coding agents.项目地址: https://gitcode.com/gh_mirrors/re/repository-harnessrepository-harness是一个以仓库为中心的工程工具能将任何代码仓库转变为适合Claude Code、Codex、Cursor等AI编码代理的就绪工作区。它为AI代理提供了小型入口点、结构化的仓库知识、持久化的执行计划以及机械验证能力让仓库本身成为默认的记录系统。为什么需要repository-harnessAI编码代理常常因为一些常见的工程问题而失败重要约束只存在于聊天记录或某个人的头脑中仓库没有明确指出哪些文档是权威的小改动被复杂流程包裹掩盖了实际工作内容大改动在会话之间丢失决策和进度验证模糊、滞后或与用户可见行为脱节repository-harness的解决方案不是增加更长的强制工作流程而是创建一个能在适当时候暴露正确上下文并通过测试和脚本强制执行重要不变量的仓库。这一方向基于OpenAI的Harness engineering理念保持代理入口点小使仓库知识可导航持久化存储复杂执行计划使应用行为可直接检查并机械地执行架构规则。repository-harness的核心优势精简的入口点→ 减少指令加载和漂移权威的仓库地图→ 代理只检索相关上下文仅为真正需要持久化的工作制定计划→ 小改动保持低成本而长期工作能跨越会话边界仓库原生测试→ 通过行为而非工作流程记录来证明完成度明确的暂停条件→ 重要的产品选择仍然由人类掌控快速开始安装repository-harness要在目标项目中安装harness只需运行以下命令在Linux或macOS上curl -fsSL https://raw.githubusercontent.com/hoangnb24/repository-harness/main/scripts/install-harness.sh?$(date %s) | bash -s -- --yes在Windows PowerShell上 ([scriptblock]::Create((irm https://raw.githubusercontent.com/hoangnb24/repository-harness/main/scripts/install-harness.ps1))) -Yes安装选项使用--merge/-Merge添加缺失的Harness文件而不替换现有项目文件使用--override/-Override仅在有意替换时使用使用--dry-run/-DryRun预览写入操作默认安装会下载经过校验和验证的Rust二进制文件harness然后使用它安装以仓库为中心的小型核心。它不会安装可选的SQLite兼容性CLI、发现模式、安装数据库引导脚本或添加数据库忽略规则。基本工作流程repository-harness根据请求的大小确定持久化流程的数量主要分为四种情况1. 只读问题检查最小的权威表面提供带有证据的答案2. 有限范围的更改本地检查修改代码或文档运行相关验证报告结果3. 多会话或需要协调的更改创建docs/plans/active/plan.md在Git中记录进度、决策和验证完成后将计划移至docs/plans/completed/4. 有重大歧义的情况在修改前暂停呈现具体选择及其影响在明确权限后继续一个拼写错误修复不需要记录、跟踪或追踪而跨多个会话的迁移则需要持久化计划。这种灵活的工作流程确保不同类型的任务都能以最适合的方式处理。探索repository-harness的工作流程示例以下是repository-harness处理四种不同请求的演示展示了它如何在不强制所有任务通过单一生命周期的情况下处理各种场景1. 只读问题请求任务何时会过期步骤阅读AGENTS.md它指向仓库地图打开相关产品契约docs/product/tasks.md根据该规则回答并引用文件不引导数据库、创建记录、写入跟踪或修改仓库这种只读路径使答案更快并防止解释过程无意中改变项目。2. 有限范围的更改请求修复任务列表使已取消的任务不被标记为过期步骤阅读过期规则并找到任务列表计算检查最近的测试和仓库验证命令在当前会话中保留简短的工作计划修改计算以要求未完成、未取消的任务为具有过去截止日期的已取消任务添加或更新回归测试运行聚焦测试然后运行仓库的相关验证门控报告更改的行为和验证结果对于这种本地且可从差异中恢复的范围创建持久化计划或数据库行只会增加同步工作而不会保留Git和测试尚未包含的信息。3. 持久化更改请求在API、工作器、UI和存储数据中使用团队时区替换本地截止日期处理步骤检查产品、架构、迁移和验证表面将docs/templates/exec-plan.md复制到docs/plans/active/下的描述性文件中记录目标、非目标、受影响的边界、阶段、风险、回滚和验证命令提交计划以便另一个会话可以仅从仓库状态恢复以可审查的组实施。每个组后更新计划中的进度和验证证据并提交工作及其持久化记录如果时区模型是未来工作必须继承的架构选择则在docs/decisions/下记录决策跨可见应用边界运行端到端验证将计划标记为完成并移至docs/plans/completed/这种跨边界的更改可能会超过一个会话的生命周期。版本化计划防止聊天历史成为序列、权衡、恢复和剩余工作的唯一记录。4. 有重大歧义的情况请求简化任务权限仓库揭示了至少两种合理的解释允许每个团队成员编辑每个任务保持所有权限制但简化权限代码步骤检查当前权限契约和调用者确定其中一种解释会改变谁可以修改用户数据在编辑代码前暂停提出两个选择及其具体影响访问扩展与仅实现重构仅在明确请求的产品行为后继续不确定性不能通过添加更多流程记录来解决而是通过将重要的产品决策留给拥有它的人来解决。仓库知识结构repository-harness提供了清晰的仓库知识结构帮助AI代理和开发人员快速找到所需信息AGENTS.md— 紧凑、稳定的代理入口点docs/WORKFLOW.md— 规范的请求和执行流程docs/HARNESS.md— 设计原则和系统模型docs/ARCHITECTURE.md— 边界和依赖方向docs/product/— 当前产品行为和约束docs/plans/— 活跃和已完成的持久化执行计划docs/decisions/— 持久化的架构决策docs/templates/exec-plan.md— 计划模板docs/README.md— 完整文档地图包括可选的兼容性表面tests/README.md— 行为所有权、验证入口点和测试套件的删除边界默认路径不需要本地数据库。产品文档、代码、测试、计划、决策和Git历史形成一个可检查的单一真相来源。更新和维护安装后可以使用以下命令预览和应用未来的核心升级scripts/bin/harness update --dry-run scripts/bin/harness update scripts/bin/harness status scripts/bin/harness doctorupdate命令读取发布的核心版本指针从确切版本化的harness-v*GitHub发布中下载平台二进制文件和校验和验证其字节和版本标识并让该候选版本合并其嵌入式核心。它拒绝降级只替换所选仓库的本地可执行文件。可选的兼容性控制平面Rust CLI、SQLite模式、功能引入、故事矩阵、跟踪评分、改进建议和编排契约仍支持明确选择它们的外部运行器或团队。它们不是普通仓库工作的先决条件。要显式安装完整的兼容性捆绑包scripts/install-harness.sh --with-cli --yes /path/to/project./scripts/install-harness.ps1 -WithCli -Yes -Directory C:\path\to\project然后引导其忽略的本地数据库scripts/bootstrap-harness.sh.\scripts\bootstrap-harness.ps1然后使用scripts/bin/harness-cli或Windows上的.exe。有关详细信息请参见scripts/README.md和兼容性索引。总结repository-harness通过提供精简的指令、可导航的上下文、必要时的持久化计划、决策记录和可执行验证将任何代码仓库转变为AI代理就绪工作区。它的灵活工作流程确保不同规模和复杂度的任务都能以最有效的方式处理同时保持仓库作为单一真相来源的权威性。无论您是个人开发者还是团队成员repository-harness都能帮助您的AI编码代理更有效地工作减少沟通摩擦并确保项目决策和进度得到适当记录和维护。要开始使用repository-harness只需克隆仓库并按照安装说明操作git clone https://gitcode.com/gh_mirrors/re/repository-harness【免费下载链接】repository-harnessTurn any repo into an agent-ready workspace for Claude Code, Codex, Cursor, and other coding agents.项目地址: https://gitcode.com/gh_mirrors/re/repository-harness创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考