awesome-code

Files (67)

• .gitignore
• CHANGELOG.md
• README.md
• ROADMAP.md
• SKILL.md
• SKILL.md · agents/backend-specialist/
• legacy-skill-full.md · agents/backend-specialist/references/
• SKILL.md · agents/brainstorming/
• SKILL.md · agents/code-reviewer/
• legacy-skill-full.md · agents/code-reviewer/references/
• SKILL.md · agents/context-optimizer/
• SKILL.md · agents/devops-specialist/
• legacy-skill-full.md · agents/devops-specialist/references/
• SKILL.md · agents/documentation-specialist/
• legacy-skill-full.md · agents/documentation-specialist/references/
• SKILL.md · agents/frontend-specialist/
• reference-research-protocol.md · agents/frontend-specialist/references/
• ui-reference-index.yaml · agents/frontend-specialist/references/
• select_ui_references.py · agents/frontend-specialist/scripts/
• SKILL.md · agents/git-workflow/
• SKILL.md · agents/mirror-optimizer/
• china-mirror-sources.md · agents/mirror-optimizer/references/
• dockerfile-mirror-templates.md · agents/mirror-optimizer/references/
• mirror-configuration-best-practices.md · agents/mirror-optimizer/references/
• SKILL.md · agents/multi-agent-coordinator/
• legacy-skill-full.md · agents/multi-agent-coordinator/references/
• SKILL.md · agents/security-specialist/
• legacy-skill-full.md · agents/security-specialist/references/
• SKILL.md · agents/systematic-debugging/
• root-cause-tracing.md · agents/systematic-debugging/
• SKILL.md · agents/tdd-workflow/
• SKILL.md · agents/writing-plans/
• config.yaml
• pyproject.toml
• ANTI_PATTERNS_LIBRARY.md · references/
• A_ROUND_PLAN_TEMPLATE.md · references/
• CONSTRUCTIVE_SUGGESTION_GUIDELINES.md · references/
• CONTEXT_MANAGEMENT_GUIDE.md · references/
• CRITICAL_THINKING_GUIDE.md · references/
• HARDCODED_BOOTSTRAP.md · references/
• INDEX.md · references/
• ISSUE_DISCOVERY_TECHNIQUES.md · references/
• SCRIPT_PATH_STRATEGY.md · references/
• code-review-checklist.md · references/
• code-reviewer.md · references/code-reviewer/
• context-optimization.md · references/
• debugging-systematic.md · references/
• git-workflow.md · references/
• multi-agent-patterns.md · references/
• tdd-best-practices.md · references/
• _config.py · scripts/
• agent_coordinator.py · scripts/
• cache.py · scripts/
• code_analyzer.py · scripts/
• create_test_session.py · scripts/
• get_path.py · scripts/
• git_helper.sh · scripts/
• logger.py · scripts/
• mirror_optimizer.py · scripts/
• performance_benchmark.py · scripts/
• …and 7 more

SKILL.md (first lines)

# Awesome Code - AI 自主规划多代理软件开发协调系统

## 目标

当用户明确要求"使用 awesome-code / 多代理协作 / 并行协调开发"时使用。通过脚本收集可用 Agent 摘要、配置约束与 `dispatch_gate`，再由 AI 负责任务拆解、角色选择和策略规划；只要计划使用 Agent，就必须把创建、隔离、串行或并行执行交给 `parallel-vibe`，本 Skill 不得直接创建或调度 Agent。当配置中的 required route agent 缺失时必须阻塞继续执行。⚠️ 不适用：用户仅需单一角色的简单修改或咨询、用户未表达多代理协作意图、用户只是了解技能概念。

## 流程

### 输入

输入为用户的复杂开发任务、项目根目录和可用 Agent 配置；可选输入包括 `config.yaml` 的 required route、`parallel-vibe` 执行底座、脚本路径和已有任务工作区。仅在用户明确要求多代理/并行协调时触发；复杂开发任务可在获得该授权后由本 Skill 规划，单一角色的局部任务不走本 Skill。

### 执行步骤

#### 执行前置：动态发现技能安装路径（硬编码部分）

在调用任何脚本之前，必须先运行 `scripts/get_path.py` 动态发现真实安装路径，并使用返回的绝对路径执行后续命令（避免硬编码 `~/.claude/skills/` / `.claude/skills/`）。

```bash
python3 ~/.claude/skills/awesome-code/scripts/get_path.py
python3 ~/.codex/skills/awesome-code/scripts/get_path.py
# 或（项目级安装）
python3 .claude/skills/awesome-code/scripts/get_path.py
python3 .codex/skills/awesome-code/scripts/get_path.py
```

从 JSON 输出中读取：
- `skill_root`
- `executable_scripts.*`（例如 `executable_scripts.agent_coordinator`）

#### 核心理念

- 脚本做确定性操作：路径发现、`agents/*/SKILL.md` frontmatter 摘要提取、配置加载、Agent 缺失检查
- AI 做语义判断：理解任务、选择 Agent、决定 single-pass / focused-agent / parallel / sequential 策略
- 少分派优先：小而明确的任务直接完成；在用户已明确授权使用本 Skill 后，只有专业风险、跨模块依赖或用户明确要求协作时才升级
- 歧义先拦截：目标、边界或验收标准不清楚的高风险/宽泛任务，由 AI 主动澄清或显式记录保守假设
- 外科手术式修改：每轮遵守 `dispatch_guidance.minimal_change_scope_default`
- 目标驱动验证：执行前先决定怎样证明完成，执行后报告验证结果
- 强制门禁：配置中的 required route agent 缺失、禁用或不可调度时，必须通过 `dispatch_gate` 阻塞继续执行
- 留痕可审计：实际调用 required agent 后，需要补 `dispatch_receipts` 才能证明门禁已被满足
- 专业化分工：每个子代理专注一个领域，降低单模型的认知负担
- 执行底座分离：`awesome-code` 只负责规划、角色选择、门禁和结果审查；Agent 的创建、工作区隔离、串行/并行调度、回收与汇总统一由 `parallel-vibe` 负责
- 渐进式信息披露：只在需要时加载对应子代理的 `SKILL.md`

#### 代理团队

| role | 领域 |
|------|------|
| tdd-workflow | TDD 测试驱动开发 |
| systematic-debugging | 系统化调试与根因分析 |
| code-reviewer | 代码审查与质量保证 |
| git-workflow | Git 工作流与版本控制 |
| frontend-specialist | 前端开发与组件设计 |
| backend-specialist | 后端开发与 API 设计 |
| devops-specialist | DevOps 与自动化运维 |
| security-specialist | 应用安全与合规 |
| documentation-specialist | 技术文档与 API 文档 |
| context-optimizer | 上下文管理与优化 |
| brainstorming | 交互式设计优化 |
| mirror-optimizer | 镜像源优化 |
| writing-plans | 实施计划与任务拆解 |
| multi-agent-coordinator | 多代理协调 |

#### 核心工作流

1. 运行 `get_path.py`，拿到 `executable_scripts.agent_coordinator` 的绝对路径。
2. 调用 `agent_coordinator.py` 收集规划上下文，读取 `available_agents`、`config_constraints`、`dispatch_guidance` 与 `dispatch_gate`。
3. 若 `dispatch_gate.can_proceed = false`：
   - 停止继续执行，不要假装已经进入实现阶段
   - 明确说明 `blocking_reason` 与 `missing_agents`
   - 只给出“如何补齐 required route agent / 配置 / 运行条件”的下一步
4. 读取 `execution_contract`。若计划使用任何 Agent，必须调用配置中声明的执行底座；若契约缺失或无效，`dispatch_gate` 必须阻塞多代理路径，不得由本 Skill 补默认底座，也不得直接调用宿主的 spawn 或并发机制。
5. 若门禁允许继续，AI 自主规划：
   - 阅读任务描述和 `available_agents` 的 `description`
   - 判断是否需要澄清；用户要求自主推进时，选择最保守且可验证的假设
   - 自行选择 `single-pass`、`focused-agent`、`parallel` 或 `sequential`
   - 若选择子代理，只加载选中 Agent 的 `awesome-code/agents/{role}/SKILL.md`
   - 若判断某个 `config_constraints.required_routes` 适用，该 route 中的 agents 视为 required
6. 按规划执行：
   - single-pass：主模型直接完成
   - focused-agent：把一个 Agent 的执行计划交给 `parallel-vibe`
   - parallel：把相互独立的 Agent 任务交给 `parallel-vibe` 并行执行
   - sequential：把存在依赖链的 Agent 任务交给 `parallel-vibe` 按序执行
   - 全程遵守 `dispatch_guidance` 的最小变更边界
7. 聚合结果并留痕：
   - 统一口径（术语/目标/约束）
   - 标注 P0/P1/P2 优先级
   - 为实际调用的 required agent 回填 `dispatch_receipts`
   - 对照自定验收标准与验证计划给出结果

#### Agent 选择指导

- Bug、测试失败和异常优先考虑 `systematic-debugging`；先根因，后修复。
- test-first、回归测试和覆盖率任务优先考虑 `tdd-workflow`。
- 安全、认证、权限、注入和敏感数据任务优先考虑 `security-specialist`。
- 前端实现、UI/UX、设计系统、仪表盘和落地页任务优先考虑 `frontend-specialist`；需要先探索方向时可先用 `brainstorming`。
- API、服务端、数据库和业务逻辑任务优先考虑 `backend-specialist`。
- 部署、CI/CD、容器和运维任务优先考虑 `devops-specialist`。
- 文档、README 和 API 文档任务优先考虑 `documentation-specialist`。
- 计划、拆解和跨代理协调分别考虑 `writing-plans` 与 `multi-agent-coordinator`。

最小示例：

```bash
python3 ~/.claude/skills/awesome-code/scripts/get_path.py
python3 /ABS/PATH/awesome-code/scripts/agent_coordinator.py "fix login bug"
```

#### 常用脚本

注意：脚本路径以 `get_path.py` 输出为准。

- `scripts/get_path.py`：输出 `skill_root` 与可执行脚本绝对路径（JSON）
- `scripts/agent_coordinator.py`：Agent 摘要收集 + 配置约束 + `dispatch_gate`
- `scripts/subagent_policy.py`：读取 required routes 并校验配置中 required route agents 是否可用
- `scripts/subagent_dispatch_audit.py`：生成 `dispatch_manifest` 并校验 `dispatch_receipts`
- `scripts/create_test_session.py`：创建 A/B 轮会话目录与计划骨架（便于追溯）
- `scripts/test_runner.py`：运行测试/覆盖率
- `scripts/code_analyzer.py`：静态分析与质量检查

From huangwb8/skills, MIT.

More from huangwb8/skills