apexyard
用工程纪律约束 AI 编码：49 个 Git Hooks + 66 个命令 + 两道 Merge Gate，让 Agent 代码安全上线
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
用工程纪律约束 AI 编码：49 个 Git Hooks + 66 个命令 + 两道 Merge Gate，让 Agent 代码安全上线
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
你用 AI 编码工具花了一个周末做出可用的原型，功能迭代速度前所未有，代码看起来"能用"。然后事情开始失控：上下文窗口渐渐装不下整个项目，AI 开始"遗忘"之前的决策，代码结构变成没人敢动的废墟，你越来越依赖和 AI 的对话记录——一旦对话关闭，那些技术决策就永远消失了。
最终，那个"马上就能上线"的项目，拖了三个月还没部署到生产环境。
这不是技术问题，这是工程治理问题。
ApexYard 正是为解决这个矛盾而生：它不是又一个 AI 编码工具，而是一套覆盖整个软件开发生命周期（SDLC）的治理框架，将工程团队的纪律注入 AI 编码工作流中。它的核心理念是：让 AI 写的代码经过真实的工程审查，才能到达用户手中。
ApexYard 的设计哲学是"一个 repo 治理所有项目"。
开发者 fork ApexYard 模板仓库到本地，这个 fork 就是整个团队的 ops repo（运维仓库）。在这个 ops repo 中注册所有需要治理的项目，ApexYard 通过共享记忆、统一规则和自动化 hooks 统一管理整个项目组合。
这套模式解决了多个 AI 编码场景下的典型痛点：
代码审查不再是摆设。 传统开发中，AI 写完代码，发个 PR，同事扫两眼点个 LGTM 就合并了——这只是形式合规，没有实质审查。ApexYard 在每次 PR 中强制执行 Rex（代码审查 agent）自动化审查，同时要求实名人类开发者显式批准，两道关卡缺一不可。
技术决策不再消失。 用 AI 写代码，速度快但决策散——为什么选这个认证方案？数据库迁移走了什么流程？这些"中间产物"过去存在于对话窗口中，对话结束就消失。ApexYard 强制要求填写 Agent Decision Record（AgDR），每个关键决策都有文档记录和可追溯的理由，直接内嵌在 PR 描述中。
质量门禁不再靠自觉。 Git 提交时，49 个 shell hooks 机械地执行质量检查：票务关联检查、secret 扫描、合规性断言、数据库迁移门禁（带 rollback 和停机评估）、禁止未审查合并。规则不是文档，是代码。
上下文不再随对话流失。 20 个角色定义（工程、产品、安全、架构等 6 个部门）持久存储在 ops repo 中，每次新对话自动激活对应角色，不再需要每次重新向 AI 解释"我们团队的代码规范是什么"。
ApexYard 提供 66 个斜杠命令（slash commands），覆盖从初始化到上线的完整流程。最核心的几个命令揭示了它的设计思路：
| 命令 | 作用 | 解决的问题 |
|---|---|---|
/setup | 三步对话配置团队信息 | 快速初始化，消除人工配置门槛 |
/handover | 接收外部仓库并注册到治理体系 | 将任意项目纳入统一治理 |
/code-review | Rex agent 执行自动化代码审查 | 每次 PR 都有 AI 质量把关 |
/decide | 记录技术决策并生成 AgDR | 决策有据可查，不再消失 |
/migration | 引导数据库迁移合规流程 | 防止"周五删列"式灾难 |
/launch-check | 上线前完整检查清单 | 消除部署前的侥幸心理 |
/inbox / /status | 聚合所有注册项目的状态 | 一个视图看遍整个组合 |
/update | 从上游同步最新治理规则 | 框架持续演进不落后 |
这些命令的共同特点是：它们是技能的入口，背后是结构化的工作流和强制规则，不是简单的 prompt wrapper。
ApexYard 以 Claude Code 为默认驱动，但核心规则、hooks 和模板都是纯文本（Markdown + Shell），不绑定任何特定工具。通过轻量适配器（adapter），ApexYard 可以驱动：
底层 enforcement 机制完全相同，换工具不影响治理规则的执行。这意味着团队可以在不改变流程的情况下迭代 AI 工具。
对于 AI 爱好者，ApexYard 的上手路径非常平缓：
无代码量要求。 不需要理解底层实现，只需要会 fork、clone、运行 /setup 三步对话——整个框架的规则通过 AI agent 内部消化，爱好者不需要接触 shell 脚本或 YAML 配置。
立刻感受到质量提升。 安装后发一个 PR，立刻体验到 Rex agent 的自动化审查反馈，以及 merge gate 对未审查代码的拦截——哪怕你是独立开发者，也立刻拥有了一个永不疲倦的 code reviewer。
适用场景丰富。 README 明确说明已在生产环境验证了 TypeScript+AWS Lambda 后端、Next.js web 应用、Chrome 扩展以及原生 Swift macOS 桌面应用，覆盖主流开发场景。
对于 AI 开发者/架构师，价值在于：
规则体系可深度定制。 18 个规则文件、23 个子 agent（Rex、Hakim、Tariq 等）、49 个 shell hooks 全部可读可改，团队可以根据自身质量标准调整 enforcement 强度和规则细节。
SDLC 全流程覆盖。 从 Planning → Design → Build → Review → QA → Deploy → Monitor 的每个阶段都有对应角色和验收标准，AI 编码不再是"游离于流程之外"的存在。
技术债务可视化。 通过 /inbox 和 /status 命令，可以在单一视图中看到整个项目组合的健康状况。
ApexYard 并非没有争议和局限：
依赖本地 Git hooks 意味着非强制性。 如果开发者主动跳过 hooks（git commit --no-verify），ApexYard 无法在服务端强制拦截。它是纪律工具，不是技术锁死。
对于个人独立开发者可能过重。 票务→审查→merge gate 流程在快速原型场景会带来显著摩擦。它明确面向"有质量要求的团队"。
Shell 为主的技术栈对非 Shell 用户有学习曲线。 理解 hooks 的执行逻辑和调试 hook 失败场景仍需要一定的基础知识。
生态锁定风险。 虽然支持多工具，但整个框架围绕 Claude Code 的设计哲学构建，换到其他 AI 编码工具时体验可能打折扣。
ApexYard 的出现反映了一个更大的行业趋势：当 AI 生成代码成为常态，传统的"人类开发者主导工程流程"正在被颠覆。Harness 公司 CEO Jyoti Bansal 的观点很有代表性："你不能通过给一个 15 年前设计的仓库添加 AI 功能来解决这个问题。整个 SDLC 必须自主化，仓库、审查、流水线、治理必须作为统一的系统运行。"
ApexYard 正是这个方向上的一种实践——不是用 AI 替代工程师，而是用工程纪律约束 AI，让 AI 的速度优势和人的质量把关结合在一起。
它代表了一种务实的 AI 工程治理思路：不追求消除人类审查，而是让审查更结构化、更自动化、更少依赖个人自觉。 在 AI 编码工具爆发式普及的当下，这类治理框架的价值会随着 AI 生成代码比例的提升而持续增长。