awesome-code

# Awesome Code - AI 自主规划多代理软件开发协调系统 ## 目标 当用户明确要求"使用 awesome-code / 多代理协作 / 并行协调开发"时使用。通过脚本收集可用 Agent 摘要、配置约束与 `dispatch_gate`，再由 AI 自主判断 single-pass / focused-agent / parallel / sequential 策略并选择子代理；当配置中的 required route agent 缺失时必须阻塞继续执行。⚠️ 不适用：用户仅需单一角色的简单修改或咨询、用户未明确表达多代理协作意图、用户只是了解技能概念。 ## 流程 ### 输入 输入为用户的复杂开发任务、项目根目录和可用 Agent 配置；可选输入包括 `config.yaml` 的 required route、脚本路径和已有任务工作区。仅在用户明确要求多代理/并行协调时触发；复杂开发任务可在获得该授权后由本 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` 才能证明门禁已被满足 - 专业化分工：每个子代理专注一个领域，降低单模型的认知负...