amplihack-expert

amplihack 专家知识

什么是 amplihack？

面向编码 CLI（Claude、Copilot、Amplifier）的工程系统：5 种机制、23 步工作流、30 多个 Agent、80 多项技能。核心入口：/dev <task>——统一的任务编排器，支持自动分类、并行工作流检测和目标驱动的执行循环。

快速参考

顶级命令

命令	用途	使用时机
/dev	编排	任何非简单任务
/analyze	审查	检查合规性
/fix	修复错误	常见错误模式
/amplihack:ddd:*	文档驱动开发	涉及 10 个以上文件的功能
/multitask	并行任务	冲刺／批量工作

顶级 Agent

Agent	职责
architect	设计
builder	编码
reviewer	质量
tester	测试

工作流

名称	步骤
DEFAULT_WORKFLOW	23
INVESTIGATION	6
FIX	3

导航指南

快速入门：SKILL.md | 架构：reference.md | 操作指南：examples.md | 深入了解：全部

核心概念

**5 种机制：**工作流（流程）、命令（入口）、技能（自动）、Agent（委派）、Hook（运行时）

**组合关系：**命令 → 工作流 → Agent → 技能

执行：/dev 负责编排——对任务分类、检测并行工作流，并通过 smart-orchestrator 配方执行，运行目标驱动的循环（最多 3 轮）

入口：/dev <task> → dev-orchestrator 技能 → smart-orchestrator 配方 → default-workflow 配方

dev-orchestrator 架构

入口：/dev <task> 或任何非简单提示词

路由：

• 问答 → amplihack:core:analyzer 直接响应
• 操作 → bash（简单）或 amplihack:core:builder（复杂）
• 开发／调查 → smart-orchestrator 配方（完整编排）

执行流程：

1. 对任务分类（architect Agent → JSON 分解）
2. 检测工作流（1 个 = 单会话，2–5 个 = 通过 multitask 并行执行）
3. 在会话树中注册会话（执行深度／容量限制）
4. 执行轮次（最多 3 轮，目标驱动的反思循环）
5. 汇总结果，提供 PR 链接和 GOAL_STATUS

会话树：防止无限递归

• AMPLIHACK_MAX_DEPTH=3（默认值）——深度编排时可增加到 5
• AMPLIHACK_MAX_SESSIONS=10（默认值）——每棵树的最大并发会话数

状态信号：

• GOAL_STATUS: ACHIEVED — 已满足所有条件
• GOAL_STATUS: PARTIAL -- [gaps] — 将继续执行下一轮
• GOAL_STATUS: NOT_ACHIEVED -- [reason] — 最终失败状态

相关文档

• reference.md：架构（5 种机制、5 个层级、Hook）
• examples.md：场景（5 个以上真实示例）
• @~/.amplihack/.claude/context/PHILOSOPHY.md：核心原则
• @~/.amplihack/.claude/workflow/DEFAULT_WORKFLOW.md：23 个步骤
• @~/.amplihack/.claude/agents/amplihack/：所有 Agent
• @~/.amplihack/.claude/commands/amplihack/：所有命令
• @~/.amplihack/.claude/tools/amplihack/hooks/：Hook 系统
• amplifier-bundle/recipes/smart-orchestrator.yaml：核心编排配方
• amplifier-bundle/tools/session_tree.py：递归防护（深度限制）
• amplifier-bundle/tools/orch_helper.py：JSON 提取助手