awesome-codelisted
Install: claude install-skill huangwb8/skills
# Awesome Code - AI 自主规划多代理软件开发协调系统
## 与 bensz-collect-bugs 的协作约定
- 因本 skill 设计缺陷导致的 bug,先用 `bensz-collect-bugs` 规范记录到 `~/.bensz-skills/bugs/`,不要直���修改用户本地已安装的 skill 源码;若有 workaround,先记 bug,再继续完成任务。
- 只有用户明确要求“report bensz skills bugs”等公开上报时,才用本地 `gh` 上传新增 bug 到 `huangwb8/bensz-bugs`;不要 pull / clone 整个仓库。
本技能用于“复杂开发任务”的多代理编排:确定性脚本只负责路径发现、Agent 摘要收集、配置约束读取和 required route 可用性门禁;任务理解、Agent 选择与执行策略由 AI 自主完成。
## 执行前置:动态发现技能安装路径(硬编码部分)
在调用任何脚本之前,必须先运行 `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 策略
- 少分派优先:小而明确的任务直接完成;只有专业风险、跨模块依赖或用户明确要求协作时才升级
- 歧义先拦截:目标、边界或验收标准不清楚的高风险/宽泛任务,由 AI 主动澄清或显式记录保守假设
- 外科手术式修改:每轮遵守 `dispatch_guidance.minimal_change_scope_default`
- 目标驱动验证:执行前先决定怎样证明完成,执行后报告验证结果
- 强制门禁:配置中的 required route agent 缺失、禁用或不可调度时,必须通过 `dispatch_gate` 阻塞继续执行
- 留痕可审计:实际调用 required agent 后,需要补 `dispatch_receipts` 才能证明门禁已被满足
- 专业化分工:每个子代理专注一个领域,降低单模型的认知负担
- 渐进式信息披露:只在需要时加载对应子代理的 `SKILL.md`
## 代理团队(14 个子代理)
| role | 领域 |
|------