内容
<p align="center">
<img src="assets/banner.svg?v=6" alt="Claude Architect: CLI coding-agent orchestration for Claude" width="880">
</p>
<p align="center">
<a href="#available-skills-agents-and-mcp-tools"><img alt="codex-implementer" src="https://img.shields.io/badge/lane-codex--implementer-d97757?style=flat-square&labelColor=0b0e14"></a>
<a href="#available-skills-agents-and-mcp-tools"><img alt="opencode-implementer" src="https://img.shields.io/badge/lane-opencode--implementer-58a6ff?style=flat-square&labelColor=0b0e14"></a>
<a href="#available-skills-agents-and-mcp-tools"><img alt="pi-implementer" src="https://img.shields.io/badge/lane-pi--implementer%20%C2%B7%20%240-3fb950?style=flat-square&labelColor=0b0e14"></a>
<a href="#available-skills-agents-and-mcp-tools"><img alt="pythinker-implementer" src="https://img.shields.io/badge/lane-pythinker--implementer-d29922?style=flat-square&labelColor=0b0e14"></a>
<a href="#available-skills-agents-and-mcp-tools"><img alt="claude-advisor" src="https://img.shields.io/badge/advisor-claude--advisor-f85149?style=flat-square&labelColor=0b0e14"></a>
<a href="#quick-start"><img alt="delegate skill" src="https://img.shields.io/badge/skill-delegate-e6edf3?style=flat-square&labelColor=0b0e14"></a>
</p>
<p align="center">
<img alt="Claude Code" src="https://img.shields.io/badge/Claude_Code-plugin-d97757?style=flat-square&labelColor=0b0e14">
<img alt="OpenCode" src="https://img.shields.io/badge/OpenCode-native-58a6ff?style=flat-square&labelColor=0b0e14">
<img alt="version" src="https://img.shields.io/badge/version-0.16.0-9aa4b2?style=flat-square&labelColor=0b0e14">
<img alt="license" src="https://img.shields.io/badge/license-MIT-3fb950?style=flat-square&labelColor=0b0e14">
</p>
**经过验证的 Claude Code 编码代理委托。** Claude 担任架构师和评审员 — 它编写规范，判断证据，并要求您做出决定。实施委托给在您选择的编码 CLI 上运行的新鲜上下文子代理实施者 — **Codex，OpenCode，Pi 或 Pythinker** — 每次调用都从干净的环境开始，没有继承的对话状态，在隔离的 Git 工作树中。工作以冻结的、哈希锚定的候选者形式返回，Claude 在单个字节到达您的检出之前，根据独立的验证证据进行审查。
实际上，这意味着插件在宿主代码中强制执行三项保证，而不是在提示中：
- **隔离** — 每个生产者都在一个独立的工作树中运行，环境经过净化，明确的写入允许列表，以及在认证的操作系统 sandboxing。出范围的更改在冻结时被拒绝。
- **证据优先于声明** — 生产者声称“测试通过”永远不会被接受；运行时会在干净的工作树中重新运行授权的验证命令，并记录实际输出。
- **人工验收** — 实现者无法批准自己的工作。审查、决策和哈希门控集成是独立的步骤，集成阶段审查树而不提交它。
## 状态
> **公共测试版：** 请勿将 Claude Architect 用于生产环境、破坏性或安全敏感的工作。在集成之前，请审查完整的候选人和验证证据。
运行时和跨平台生命周期正在不断演化。生产者可用性取决于主机操作系统、CLI 版本、身份验证、请求的通道和已证明的执行能力。
## 为什么存在
委托代码生成很容易；但是确定生成的确切字节、它们是否在范围内以及是否有人独立验证它们则更为困难。Claude Architect 使 Claude 专注于规范和判断，同时将外部编码代理视为不受信任的生产者。它记录可复制的运行、冻结内容寻址的候选者、在干净的材料化中验证授权的检查，并使人类决策明确。
## 核心工作流程
```mermaid
flowchart LR
A[版本规范] --> B[生产者在独立工作树中]
B --> C[冻结候选者]
C --> D[独立验证]
D --> E[对抗审查]
E --> F{人类决策}
F -->|接受| G[受保护的集成]
F -->|拒绝或修订| H[丢弃或重新尝试]
```
所有代理输出都是不受信任的候选者；实现者无法批准自己的工作；只有人类才能接受。
## 安装
Claude Code 需要 Node.js 22 或更高版本。添加市场并安装插件：
```bash
claude plugin marketplace add Pythoughts-labs/claude-architect
claude plugin install claude-architect@claude-architect
claude plugin list --json
```
安装或更新后重启 Claude Code。安装并认证至少一个支持的生产者 CLI（`codex`、`opencode`、`pi` 或 `pythinker`）；Claude Architect 报告不可用的通道，而不是静默替换另一个代理。
## 快速开始
在 Git 仓库中打开 Claude Code 并指定您要使用的生产者：
```text
/claude-architect:delegate 使用 Codex 添加速率限制到公共 API，运行测试，并在集成前向我展示独立审查的候选者。
```
如果未指定生产者，则技能会要求您选择 Codex、OpenCode、Pi 或 Pythinker。Pi、OpenCode 和 Pythinker 是适配器，接受可选的模型和思维/变体覆盖；通道内的模型选择是可选的，否则默认为该 CLI 配置的默认值。对于非琐碎的工作，它使用新鲜上下文审查管道。在决定是否接受之前，请阅读确切的补丁、发现和验证输出。
## 可用的技能、代理和 MCP 工具
| 类型 | 名称 | 目的 |
|---|---|---|
| 技能 | `/claude-architect:delegate` | 构建版本化的规范并驱动委托、审查、决策和受保护的集成。 |
| 代理 | `advisor` | 当前严格的只读承诺边界顾问。 |
| 旧代理 | `claude-advisor` | 保留用于迁移的旧第二意见顾问。 |
| 旧代理 | `codex-implementer`、`opencode-implementer`、`pi-implementer`、`pythinker-implementer` | 特定于 CLI 的迁移通道；可用性和限制因情况而异。 |
| MCP | `delegate` | 运行经过验证的、隔离的、独立验证的尝试。 |
| MCP | `delegatePipeline` | 运行新鲜上下文实现/审查/修复管道。 |
| MCP | `reviewCandidate` | 返回确切的冻结补丁和验证证据。 |
| MCP | `decideCandidate` | 记录接受、拒绝或修订请求。 |
| MCP | `integrateCandidate` | 在安全保护下应用接受的哈希匹配候选者。 |
| MCP | `doctor` | 报告运行时、Git、平台和生产者诊断。 |
| MCP | `gitStatus`、`gitDiff`、`gitLog`、`gitChangedFiles` | 适用于顾问的边界、编辑、只读 Git 证据。 |
## 安全和信任模型
Claude Architect 在角色和工件之间分离权限。生产者接收到有界的写入范围，在隔离的工作树中。候选字节在独立验证之前被冻结并通过哈希识别。审查者在新鲜的上下文中操作，而只读角色缺乏变异工具。运行时拒绝嵌套委托、范围逃逸、更改基线、不匹配的锚点或树以及未接受的候选者。集成阶段审查字节；它不会提交它们。
中心规则是简单而刻意的：**所有代理输出都是不受信任的候选者；实现者无法批准自己的工作；只有人类才能接受。** 验证减少了风险，但不能确定更改对于您的特定部署是安全的。
## 权限和外部命令
插件使用 `${CLAUDE_PLUGIN_ROOT}/runtime/bootstrap.mjs` 启动其 MCP 服务器。它可能会调用 Git、Node.js、配置的验证可执行文件和选定的生产者 CLI。生产者进程只能通过合格的隔离通道编辑；验证命令是主机授权的，其隔离/网络强制执行会诚实地报告。运行时使用可执行文件加 argv 调用、净化环境、有界超时、进程树终止、可执行文件策略和路径验证。永远不要授权机密、部署命令、破坏性命令或比任务要求的更广泛的写入全局。
Codex 编辑隔离使用 `codex-native-sandbox`：本地 macOS arm64 已认证，Linux 在无特权用户命名空间允许原生 sandbox 的情况下进行测试，本地 Windows 编辑不受支持。未支持或失败的隔离仅用于诊断，并且关闭后失败。Codex 适配器强制执行 `--disable multi_agent` 以及 `features.multi_agent_v2={enabled=false,max_concurrent_threads_per_session=1}`。已安装的市场副本必须更新并重新加载 Claude Code，然后新的运行时或适配器控制才会生效。
## 数据存储和隐私
持久运行状态、清单、冻结的工件、决策和恢复元数据存储在 Claude Code 提供的 `${CLAUDE_PLUGIN_DATA}` 目录下。临时隔离工作树和进程文件使用操作系统的临时存储，并由运行时恢复或修剪。旧通道诊断可能会在 `${TMPDIR:-/tmp}/claude-architect-runs` 下写入有界运行元数据，除非被覆盖。
日志和 MCP 证据是有界和编辑的；不会故意记录提示/参数值。生产者 CLI 和任何配置的模型提供者都有其自己的遥测、保留和隐私策略。请勿在委托规范、提示、测试夹具或命令参数中放置凭证或敏感数据。
## 限制和非目标
- 这是一个公共测试版，而不是自动合并或部署系统。
- 它不证明业务正确性、消除供应链风险或取代人类安全审查。
- 原生 Codex 编辑隔离当前在 macOS arm64 上认证；其他平台/生产者组合可能经过测试、旧版、仅限诊断或不可用。
- OpenCode、Pi 和 Pythinker 旧通道在适配器迁移期间保持打包，不意味着与 MCP Codex 路径相同的认证。
- 验证命令是证据，而不是自动沙箱构建基础设施。
- 集成阶段接受的候选者，但永远不会提交、推送、打开拉取请求或部署它。
## 开发和测试
```bash
npm install
npx tsc --noEmit
npx vitest run
bash scripts/validate-release.sh
claude plugin validate .
```
在每次克隆后启用本地推送门控：
```bash
git config core.hooksPath .githooks
```
有关架构边界、信任不变量、测试要求、打包规则和次要版本发布策略，请参阅 [AGENTS.md](AGENTS.md)。
## 支持和安全报告
对于可复制的错误和支持问题，请使用 [GitHub Issues](https://github.com/Pythoughts-labs/claude-architect/issues)。对于疑似漏洞，请使用存储库的私有 GitHub 安全报告通道，而不是公共问题。包括插件版本、主机操作系统/架构、Claude Code 版本、生产者 CLI/版本、编辑的诊断和重现步骤。
## 贡献
欢迎贡献。请保持更改范围狭窄，添加证明相关信任属性的测试，运行所有存储库检查，并解释平台或安全影响。在处理运行时之前，请阅读 [AGENTS.md](AGENTS.md)。
## 许可证
Claude Architect 在 [MIT License](LICENSE) 下获得许可。
连接信息
猜你喜欢
暂无推荐服务器