Claude-Agent-System

# 克劳德代理系统 **深度研究。精确委托。刻意并行。保持敏感操作受控。** 克劳德代理系统（CAS）是一款专注的克劳德代码插件，围绕四种在实际会话中有用的工作流程构建： | 核心能力 | 命令 | 目的 | |---|---|---| | 深度研究 | `/spectre` | 并行研究、综合和独立声明验证 | | 代码委托 | `/gpt-architect` | 克劳德保持架构控制，同时正常的代码库MCP处理专注的仓库工作 | | 显式并行执行 | `/hydra` | 确定性克劳德代理团队，用于多个协调任务 - 无需动态工作流 | | 安全周界 | `/setup-hooks` | 验证秘密保护和移除、提交、推送的批准门控 | 插件的其余部分作为可选工具箱提供，但这四种能力定义了推荐的CAS体验。 ## 安装 在克劳德代码中运行以下命令： ```text /plugin marketplace add Kasempiternal/Claude-Agent-System /plugin install cas ``` 升级后，启动新的克劳德代码会话，以便加载当前的技能和钩子定义。 ## 三种执行模式 CAS保持委托模式的显式。它们是用于不同作业的工具，而不是不加区分地堆叠的层。 ### 1. 直接克劳德 这是默认模式。克劳德直接读取、编辑、运行工具并与您交谈。将其用于不需要委托的正常工作。 ### 2. GPT架构师 当克劳德应保持架构师角色，而代码库执行专注的实现、诊断或审查时，请使用 `/gpt-architect`。 ```text /gpt-architect 调查失败的同步测试并实施验证的修复 /gpt-architect on /gpt-architect off ``` - 一次性表单委托仅限于提供的任务。 - `on` 使代码库成为当前对话的独家委托后端。 - `off` 立即恢复原生的克劳德队友。 - 新会话始终以关闭状态启动；不会创建标记文件、后台工作器或全局模式。 - 在委托前，克劳德会显示 `Codex → <模型>/<努力>: <任务>`，以便您了解正在运行的内容和原因。 GPT架构师使用单独配置的**正常代码库MCP**。CAS不会安装包装服务、审批窗口、监视器、舰队或配额守护程序。 ### 3. 原生克劳德代理团队 当任务真正受益于协调的原生克劳德队友时，请使用 `/spectre` 或 `/hydra`。 代理团队和GPT架构师故意是互斥的。如果您的会话中可见 `GPT-A ON`，请运行： ```text /gpt-architect off ``` 然后调用 `/spectre` 或 `/hydra`。如果GPT架构师仍处于开启状态，这两种技能都会在启动团队之前停止，以防止混淆的钩子失败和意外的混合编排。 ## GPT架构师路由 克劳德为每个代码库调用选择模型和努力级别。目标是找到最低成本的路线，同时仍然匹配任务的风险和模糊性。 | 模型 | 默认通道 | |---|---| | `gpt-5.3-codex-spark` | 微小、近乎瞬间、低风险的编辑，在已知曲面上 | | `gpt-5.6-luna` | 机械转换、提取、分类和精确结构化工作 | | `gpt-5.6-terra` | 日常实施、调试、测试和专注的代码审查 | | `gpt-5.6-sol` | 架构、安全、并发、性能或模糊的跨系统工作 | | 努力 | 含义 | |---|---| | `low` | 明显且主要是机械的 | | `medium` | 有界工作，需要普通的规划和验证 | | `high` | 具有有意义的边缘情况或权衡的行为工作 | | `xhigh` | 具有交互不变性或实质性不确定性的困难工作 | | `max` | 最难的单一连贯问题 | | `ultra` | 显式授权的并行委托，用于真正独立的分支 | 典型的默认设置是 Spark `low` 或 `medium`，Luna `low` 或 `medium`，Terra `medium` 或 `high`，而 Sol `high` 或 `xhigh`。`max` 是例外。`ultra` 是并行模式，而不是通用质量开关。 ### Spark的快速通道 Spark故意狭隘。只有在文件或微小曲面已知、预期行为无歧义、更改风险低且专注检查可以验证时，才适用。 不要将Spark用于仓库发现、广泛诊断、同步、网络可靠性、身份验证、权限、安全、隐私、持久性、迁移、依赖项、并发或发布行为。这些直接适用于Terra或Sol。 在Spark写入可执行代码后，克劳德检查差异和验证，通常会请求单独的只读Terra `medium`审查。实质性审查发现由Terra或Sol纠正 - 而不是通过反复将Spark推到其通道之外。 ## 安全合同 CAS保护一组狭隘的高后果行动，不会中断普通开发。 | 操作 | 行为 | |---|---| | 读取或更改 `.env`、凭证、私钥或包含秘密的数据 | 通过秘密保护钩子询问 | | 任意 `rm` 命令 | 询问 | | `git commit` 或 `git commit-tree` | 询问 | | `git push` | 询问 | | 构建、测试、格式化器、包管理器、普通编辑和只读Git | 自动继续 | 钩子解析器识别常见的包装器、嵌套shell命令、赋值和全局Git选项。它不依赖于脆弱的子字符串检查。 当GPT架构师委托工作时，代码库绝不能执行 `rm`、`git commit` 或 `git push`。代码库停止并将拟议的命令返回给克劳德；只有克劳德可以调用它，CAS钩子成为唯一的审批点。这在不为每个测试命令创建审批噪音的情况下，保持了敏感的仓库状态更改的可见性。 运行 `/setup-hooks` 以验证已安装的合同并删除旧CAS安装中的过时重复钩子。 ## `/spectre`：证据研究 Spectre将研究问题分解为独立的方面，发送平行研究人员跨越网络、代码库和提供的文档，综合他们的发现，并在编译报告之前验证重要声明。 ```text /spectre 比较当前的大型Swift仓库的代理编码模型 /spectre 调查此仓库中的同步架构和当前的GitLab API指导 ``` Spectre从快速扫描中分类范围，显示拟议的方面，并在花费更大的研究预算之前请求确认。 要求： - `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` - 当前会话的GPT架构师关闭 - 研究需要当前外部证据时的互联网访问 ## `/hydra`：刻意的原生并行性 Hydra是显式替代不透明的工作流路由。给它几个任务；它一起探索它们，检测跨任务文件冲突，构建依赖图，并仅以并行波的方式执行安全分支。 ```text /hydra 修复身份验证；添加仪表板过滤器；强化同步重试 /hydra 1. 重构模型 2. 添加API端点 3. 更新测试 ``` Hydra在调用后拥有工作流。它不会将请求交给克劳德动态工作流、`/zk`、`/systemcc` 或另一个路由器。 要求： - `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1` - 当前会话的GPT架构师关闭 如果代理团队未启用，请仅使用 `/setup-swarm` 一次。 ## 可选工具箱 CAS仍然为需要它们的用戶提供专门的和历史的工作流程。它们故意是核心堆栈的次要部分。 ### 有用的专家 | 技能 | 用途 | |---|---| | `/review` | 七视角代码审查，带有可选的修复阶段 | | `/cyberconan` | 安全聚焦的仓库评估 | | `/gonk-test` | 通过捆绑的Spectra MCP服务器进行无头浏览器测试 | | `/cccontrol` | 通过无障碍API进行快速原生macOS UI控制 | | `/phoenix` | 面向恢复的工作流 | | `/l30` | 会话和项目报告 | ### 兼容性和实验工作流 `/faster`、`/legion`、`/orchestrate`、`/pcc`、`/pcc-opus`、`/siege`、`/systemcc` 和 `/zk` 仍然安装用于兼容性和实验。它们保留了早期的CAS编排样式，但它们不是新会话的推荐默认路径。 其中几个技能使用原生队友。如果GPT架构师处于开启状态，请在调用它们之前将其关闭。 ## 要求 - 带有插件支持的克劳德代码 - 用于钩子脚本和捆绑的基于节点的集成的Node.js - 为 `/gpt-architect` 单独配置的正常代码库MCP - 仅为需要它的原生群集技能启用代理团队 - 由专家技能（如 `/cccontrol` 和 `/gonk-test`）记录的可选平台依赖项 ## 仓库映射 ```text .claude-plugin/ 市场表现 claude-agent-system-plugin/ hooks/ 自动安全和模式守卫 skills/ 克劳德代码技能 agents/ 捆绑的审查代理 cccontrol-mcp/ 原生macOS控制桥 docs/ GitHub Pages网站 spectra-mcp-server/ 无头浏览器MCP服务器 ``` ## 贡献 CAS倾向于少量的清晰执行模式而不是重叠的路由器。在提出新技能之前，请检查行为是否属于Spectre、GPT架构师、Hydra、安全钩子或现有专家。 参见 [CONTRIBUTING.md](CONTRIBUTING.md) 以获取验证和拉取请求期望。 ## 许可证 [MIT](LICENSE) © Kasempiternal