me2resh/apexyard

ApexYard – AI辅助代码项目治理

概述 ApexYard是一个运营仓库，团队可以分叉（fork）并使用它来管理由AI编码代理（如Claude Code、opencode、pi或Codex）构建（或大量辅助）的软件项目组合。它不运行任何服务；它只是一组纯文本Markdown文件、Bash钩子和AI代理读取并执行的斜杠命令“技能”。

为什么重要 AI可以快速生成可工作的代码，但将这些代码安全地移入生产环境仍然需要通常的软件开发保障——票证、审查、质量门禁、迁移计划等。ApexYard以可重复使用、与工具无关的方式将这些保障编纂成文，因此无论您使用Claude Code、opencode、pi、Codex还是Cursor IDE，相同的治理规则都适用。

主要组件

• 角色（约20个） – 模拟人物（如审查员Rex、安全卫士Hakim）并在特定触发器上激活的Markdown文件。
• Shell钩子（约60个） – 在git/gh命令上运行的Bash脚本，以强制“票证优先”编辑、双标记合并门禁、秘密扫描、迁移检查等。
• 斜杠命令技能（约68个） – 如/setup、/handover、/decide、/code-review、/migration、/launch-check等命令，AI代理可直接从IDE调用。
• 子代理 – 执行专业审查或检查的小型代理（Rex、Hakim、Tariq等）。
• 配置文件 – onboarding.yaml（git忽略）保存项目特定设置；apexyard.projects.yaml跟踪受治理的仓库列表。

典型工作流

1. 分叉ApexYard仓库并克隆它。
2. 运行**/setup**（或复制onboarding.example.yaml）来配置组织的策略。
3. 使用**/handover <repo>**将代码库添加到组合中；该命令克隆仓库，评估其“可 harness 性”，并将其记录在apexyard.projects.yaml中。
4. 在整个开发过程中，代理调用诸如/code-review <pr>或/decide之类的技能来记录决策，而Bash钩子会阻止任何违反票证优先或合并门禁规则的git操作。
5. 当PR准备好时，指定的人类（以及可选地Rex代理）必须明确批准确切的提交，合并门禁才能打开。
6. 定期**/update**使分叉与上游ApexYard更改保持同步，Conformance CI作业会重新验证所有受支持的AI工具是否仍然遵守规则。

工具支持

工具	强制执行	设置步骤
Claude Code	✅ 原生（无需额外安装）	只需运行/setup
opencode	✅ 已验证（适配器脚本）	bash bin/install-opencode-adapter.sh
pi	✅ 已验证	bash bin/install-pi-adapter.sh
Codex	✅ 已验证	bash bin/sync-codex-adapter.sh
Cursor	✅ IDE内原生（加载.claude/）	启用第三方配置 + bash bin/install-cursor-adapter.sh

自定义 所有角色、工作流和文档模板都是纯文本Markdown文件，因此团队可以添加新角色、编辑现有工作流或添加其他模板，而无需接触任何编译代码。

开始使用 README引导您完成六步快速入门（分叉 → 克隆 → 添加上游 → /setup → /handover → 开始使用组合命令）。状态行插件（apexyard-status）可以添加到Claude Code提示中，以显示活动票证和待处理的批准。

潜在用户

• 允许AI代理编写代码但需要纪律严明的SDLC的公司。
• 管理许多微服务或前端应用并希望为策略提供单一事实来源的团队。
• 更喜欢“无服务”、基于文件的治理层并支持多种AI编码助手的开发人员。

---

以上所有细节均直接取自仓库的README；没有推断任何额外功能。