ai-collab-modellisted

# AI-Collab-Model（协作总控） ## Overview 定义"AI 怎么和负责人一起工作"的总控规范。核心：**主对话当协调者（计划、派发、汇总，不亲自写码），subagent 分工干活**；配合质量门禁、教学两种模式、文档规范、找 skill 前置。适用于任何嵌入式/AI 协作项目，借鉴 great_cto 的 coordinator 编排模式 + superpowers 调度。 ## When to Use - 新项目开工：先跑 `project-setup`，再用本 skill 把协作模型铺进 CLAUDE.md - 任务拆解：决定"这活主对话做还是派 subagent" - 决定教学模式 / 质量门禁 / 文档归位 - 需要找现成 skill 时 不用：纯读代码、单文件小改（直接做，别编排）。 ## 1. 分工模型（核心） ``` 主对话（协调者）─── 规划/任务卡/派发/汇总/审核 ├─ dispatch → subagent-代码编写（写/改隔离的代码模块） ├─ dispatch → subagent-教学（两种模式，见 §4） └─ dispatch → subagent-审核（质量/冗余，调 simplify） ``` **协调者铁律**（借鉴 great_cto coordinator）： - 只 **DECOMPOSE→DISPATCH→MONITOR→SYNTHESIZE**，不亲自做隔离的重活 - 每个任务卡写清边界：做什么 / 动哪些文件 / **别碰什么**（禁改清单） - **handoff 契约**：subagent 交付必须按 `references/roles.md` 的格式回传（改动清单、验证方式、遗留风险） **别过度编排**： - 单个小任务（≤1 文件、边界清晰）→ 主对话直接做，不派发 - 2 个顺序步骤 → 直接顺序做 - **3+ 独立流 / 需要并行调研 / 跨多模块** → 才并行派发（用 superpowers:dispatching-parallel-agents） ## 2. 质量门禁（写进项目 CLAUDE.md 的固定条款） 新项目 CLAUDE.md 必须包含以下条款（原文照抄）： > **代码质量门禁**：所有代码必须简洁、可读、低冗余、鲁棒。深嵌套/重复样板必须收敛（优先抽公共函数、宏、表驱动）。每次交付前用 simplify skill 或审核 subagent 过一遍，未通过不进 build-verify。 实施要点： - 冗余 → 收敛；深嵌套 → 提前 return / 拆函数；魔法数 → 命名常量 - 每张任务卡交付前：主对话调审核 subagent 或 `/simplify`，把结果写进任务卡 - 禁改文件里的冗余只报告不擅动（需另开任务卡授权） ## 3. 教学模式（两种，分阶段切换） 详见 `references/teach-code.md`。摘要： | 模式 | 适用 | 做法 | |------|------|------| | **A·指导编写**（学习） | 核心架构 / RTOS / 控制算法 | 阶段1·新手带写：AI 写一小步+讲原理，你仿写/修改；阶段2·熟练出题审：AI 给任务+提示+原理，你写，AI 审+引导 | | **B·生成+审核**（速度） | 外围弱化 / 样板 / 驱动 | AI 生成 → 审核 subagent 审�� → 你取舍 | 选择依据：**要练手/