克劳德·萨奇
](https://github.com/arikusi/claude-sage/releases)   
“先分析，后修复” --Claude Code CLI的工作流系统
Claude Code的基于代理的工作流系统，强调仔细分析、战略规划和受控实施。不再有成为技术债务的快速解决方案。
______________________________________________________________________
开始前快速记下
MCP服务器-说真的，安装这些： 一、 *高度地* 建议设置MCP服务器（尤其是 背景7 和 艾克萨).正是它们造就了 horizon-explorer 代理人如此强大。没有他们，你就错过了：
相信我，这些不是可有可无的好东西——它们会改变游戏规则。
重要提示： 安装MCP 本地 （不是作为远程/云托管服务器）。子代理无法与远程MCP进行身份验证，并将自动回退到无操作。代理需要本地安装才能使用它们。
______________________________________________________________________
核心理念
不要急于修复。开始正确的建设。
该系统用结构化的多智能体方法取代了“快速修复”思维：
- 分析 问题很严重（没有代码更改）
- 建筑师 战略性解决方案（超薄模式）
- 探索 替代视角（卡住时）
- 修复 在明确批准的情况下谨慎行事（测试驱动）
______________________________________________________________________
快速开始
选项1——插件安装：
/plugin marketplace add arikusi/arikusi-marketplace
/plugin install claude-sage@arikusi-marketplace选项2——告诉Claude为您安装：
# Open Claude Code CLI
claude
# Then say:
"Add the marketplace and install claude-sage:
/plugin marketplace add arikusi/arikusi-marketplace
/plugin install claude-sage@arikusi-marketplace"就是这样！克劳德会为你安排好一切。
______________________________________________________________________
代理团队
1. 问题分析员
- 角色：法医调查员
- 工具：读取、Grep、Glob、Bash（只读）
- 权力：无法编写/编辑代码
- 目的：深入的根本原因分析、影响评估、报告
何时使用： /analyze [problem description]
2. 解决方案架构师
- 角色：战略架构师
- 模型：作品+延伸思维
- 工具：读取、Grep、Glob、Bash、任务创建/更新（代码只读）
- 权力：无法编写/编辑代码--生成包含分步任务的详细计划
- 目的：架构决策、权衡分析、3+替代方法
何时使用： /architect [architectural decision]
3. 地平线探测器
- 角色：横向思考者
- 工具：阅读、Grep、Glob、Bash、Exa MCP、Context7、WebSearch
- 权力：无法编写/编辑代码，研究超能力
- 目的：另类观点，非传统解决方案，“我们找对地方了吗？”
何时使用： /explore [stuck problem]
4. 受控固定器
- 角色：细心的外科医生
- 工具：读取、Grep、Glob、编辑、写入、Bash、任务创建/更新
- 权力：可以修改代码（仅在明确批准的情况下，在独立的工作树中）
- 目的：在单独的git分支中进行测试驱动、可逆、最小影响的修复
何时使用： /fix （经过分析和批准）
5. 代码审查员
- 角色：独立质量门
- 模型：作品+延伸思维
- 工具：读取、Grep、Glob、Bash（只读）
- 权力：无法修改代码--生成已批准/需要更改/已阻止
- 目的：安全性（OWASP）、逻辑正确性、边缘情况、测试覆盖率审查
何时使用： /review （之后 /fix，合并前）
______________________________________________________________________
快速命令
| 命令 | 调用 | 它做什么 | 修改代码？ |
|---|---|---|---|
/analyze | 问题分析师 | 深度问题分析+报告 | 否 |
/architect | 解决方案架构师 | 战略规划（扩展思维，opus） | 否 |
/explore | 地平线探索者 | 替代方法 | 否 |
/fix | 受控固定器 | 在工作台上仔细实施 | 是（如果批准） |
/review | 代码审阅者 | 合并前的独立审阅 | 否 |
/setup-project | -- | 为新项目初始化Claude | 是 |
______________________________________________________________________
标准工作流程
工作流程1：简单的Bug修复
1. /analyze "npm test failing on auth module"
→ problem-analyst: detailed analysis + root cause
2. You: "Okay, proceed with the fix"
→ /fix
→ controlled-fixer: test-driven fix in isolated worktree
3. /review
→ code-reviewer: APPROVED
4. git merge [branch]工作流程2：关键架构决策
1. /analyze "should we migrate to microservices?"
→ problem-analyst: current state analysis
2. /architect "microservices migration strategy"
→ solution-architect: 3+ approaches, trade-offs, risks
3. You: decide which approach
4. /fix [chosen approach]
→ controlled-fixer: careful implementation in worktree
5. /review
→ code-reviewer: review + merge decision工作流程3：卡住数小时
1. /explore "we can't solve the race condition in our queue"
→ horizon-explorer: alternative patterns, different tech stacks
→ "Are we looking in the right place?"
2. /analyze [new perspective]
→ problem-analyst: re-analyze with new insights
3. /architect [solution]
→ solution-architect: strategic plan
4. /fix → /review → merge______________________________________________________________________
最佳实践
做
- 始终从分析开始 -永远不要跳过理解
- 关键变更的使用/架构师 -获取战略指导
- 卡住时呼叫/探索 -新视角
- 批准前/修复 -仅限受控变更
- 请求“超薄” -对于复杂的决策
不要
- 跳过分析 -理解>速度
- 权宜之计 -今天的捷径=明天的债务
- 单一视角 -不确定时使用/探索
- 未经测试的生产变更 -受控修复程序执行测试
- 在没有警告的情况下打破变化 -代理人将标记
______________________________________________________________________
特性
智能权限
{
"allow": ["Bash(git:*)", "Bash(npm:*)"],
"deny": ["Bash(rm:-rf:*)"]
}后置工具挂钩
{
"PostToolUse": [{
"matcher": "Edit|Write",
"hooks": [{"command": "prettier --write $FILE"}]
}]
}延伸思考
{
"env": {
"MAX_THINKING_TOKENS": "31999"
}
}MCP集成
工作流系统是 *显著地* MCP服务器功能更强大：
没有MCP： 基本工作流程可行，但 horizon-explorer 失去了80%的研究能力。 使用MCP： 全功能替代研究、新的代码示例和全面的文档。
在本地安装MCP。 子代理（通过代理工具生成）无法与远程/云托管的MCP服务器进行身份验证——它们将默默地无法使用它们。所有MCP服务器必须在您的计算机上本地安装并运行，以便代理可靠地访问它们。
______________________________________________________________________
文档
- 工作流-GUIDE.md：全面的工作流程文档
- 代理文件：每个代理都有详细的说明
- 命令文件：Slash命令定义
______________________________________________________________________
代理决策矩阵
| 场景 | 代理 | 为什么 |
|---|---|---|
| “为什么会失败？” | 问题分析师 | 分析没有变化 |
| “我们应该使用GraphQL还是REST？” | 解决方案架构师 | 战略权衡 |
| “我们被困了3个小时” | 地平线探险家 | 新视角 |
| “执行批准的修复程序” | 受控修复程序 | 谨慎执行 |
| “Cron作业间歇性失败” | 问题分析师→ 架构师 | 比赛条件需要深入分析 |
| “数据库迁移策略” | 架构师 | 关键架构决策 |
______________________________________________________________________
高级用法
自定义代理
将您自己的代理添加到 ~/.claude/agents/:
---
name: your-agent
description: What it does
tools: Read, Grep
disallowedTools: Write, Edit
model: sonnet
---
# Your Agent Instructions
...______________________________________________________________________
______________________________________________________________________
*“今天快解决，明天大问题。”*
先了解问题。修复一次，修复正确。
______________________________________________________________________
📜 许可证
麻省理工学院