awesome-code

# Awesome Code - AI 自主规划多代理软件开发协调系统 ## BenszAPI 任务工作区 本 Skill 的新任务中间文件统一写入 `./.bensz-api/task-{yyyymmdd-hhmm}-{简短描述}/{skill名}/input|output|log/`。同一任务复用一个任务根目录；多 Skill 协作才创建 `shared/`。正式交付物不写入该目录，历史隐藏目录只允许显式兼容读取、迁移或清理。 本技能用于“复杂开发任务”的多代理编排：确定性脚本只负责路径发现、Agent 摘要收集、配置约束读取和 required route 可用性门禁；任务理解、Agent 选择与执行策略由 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 整个仓库。 ## 执行前置：动态发现技能安装路径（硬编码部分） 在调用任何脚本之前，必须先运行 `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_ga...