renjianguojinqianfan/Project-Bootstrap-Harness

README 摘要

Project-Bootstrap-Harness (PBH) 一个为 AI 辅助编程设计的 项目协议模板 。 我们不教 AI 怎么思考，我们为它提供最佳的执行环境。 为什么需要这个？ 用 Claude Code、Cursor 或 OpenCode 写代码时，你大概率遇到过这些摩擦： - 每次新会话都要重新交代规则 ："记得跑测试"、"别改无关文件"、"先写计划再编码" - AI 写了代码却不验证 ：小错误滚雪球，最后人类来兜底 - 切换 AI 工具时上下文断裂 ：Claude Code 理解的规则，Cursor 不知道 问题不在于 AI 不够聪明，而在于项目本身缺少一份"默认协作协议"。 PBH 在 harness-init my-project 的瞬间，把协议、质量门禁和状态记录种进项目。从此，任何打开这个项目的 AI 工具都能在 30 秒内知道：这里怎么跑测试、质量底线在哪里、当前项目处于什么阶段。 它是什么（以及不是什么） ✅ PBH 是 - 一份通用协作协议 ： AGENTS.md 作为所有 AI 工具的共同入口，定义致命规则、工作准则和项目结构 - 一套质量门禁基础设施 ： make verify 开箱即用，lint + 格式检查 + 测试 + 覆盖率一气呵成 - 一个可观测的 Agent 行为基准 ：同一份 AGENTS.md ，你可以观察不同 AI 工具的遵循程度和表现差异 - 一个 Spec Coding 容器 ：提供 tasks/ 目录供你拆解任务，内容完全由你掌控 - 一个"协议的一次性播种器" ：在项目创建时种下规则，让约束随项目走，不随人走。 - 一套生态协议标准 ：详见 docs/spec/PBH-SPEC.md — 定义了 AI 项目协作的通用规范，任何语言均可实现兼容工具。 ❌ PBH 不是 - 不是 Agent 框架 ：不定义 AI 角色，不实现多智能体调度 - 不是代码生成器 ：不根据自然语言描述生成业务代码 - 不是 Spec Coding 流程工具 ：不生成 PRD、SPEC、constraints.md，只提供存放它们的目录 快速开始 进入项目并验证： 💡 如果 make 命令不可用 Windows 用户可能未安装 make。若提示 'make' 不是内部或外部命令，你可以： 安装 make： - Windows：安装 GnuWin32 Make 或运行 winget install GnuWin32.Make - macOS： xcode-select --install - Linux： sudo apt install make 或等价命令 或直接运行等价命令： 邀请 AI 入场： "请阅读 AGENTS.md，了解这个项目的规则，然后帮我开始工作。" 生成的项目结构 AGENTS.md：所有 AI 工具的共…

分类