郭哥-并行代码开发工作流
什么时候用（触发）
用户提出非琐碎、多文件/多模块代码功能需求时，例如：
- 给智客AI加一套新模块 / 重构 guogeai.com 某个子系统
- 同时改多个独立组件 / 一次性补多个页面
- 用户说「并行搞」「多个一起上」「同时接几个供应商」
不走本流程：文案/配图/单行修复/纯配置微调 → 直接改，别折腾。
核心心法（第一性原理）
新时代的胜负手从「写代码」转向「设计任务怎么分给AI」。
最大并发AI数 = (代码规范度 × 测试覆盖率) / 任务耦合度
含义：模块越解耦、铁律越硬、测试越全 → 能安全并行开的 agent 越多。 本 Skill 的本质是操作规程（我执行），不是咨询人设——所以做成 Skill 而非 Expert。
标准流程
第0步：先找轮子（必须，复用现有 Skill）
调用 find-wheels-first-methodology：先搜现成开源方案/已有 Skill/本地代码，能复用不重写。
→ 避免各并行 agent 各自造重复轮子、彼此冲突。
第1步：拆原子任务
把需求拆成互相独立、可并行的最小单元。
- 例：支付模块 → Stripe接入 / PayPal接入 / 对账逻辑 三个独立子任务
- 判定标准：子任务之间无共享可变状态、无交叉文件依赖
第2步：耦合度判定（决定并行还是串行）
| 条件 | 策略 |
|---|---|
| 任务间共享文件/共享状态 | 串行，或先拆到不共享再并行 |
| 任务间边界清晰、各自独立目录/模块 | 并行 |
| 单仓库多模块且需同时改 | 并行 + Git Worktree 物理隔离 |
第3步：派发执行
- 并行：为每个原子任务起一个独立子agent，每个 agent 在隔离目录工作。
- 同仓库多模块 →
git worktree add ../<项目名>-<子任务> -b feat/<子任务>建独立工作副本，互不干扰 - 跨仓库（如智客AI / guogeai 各独立） → 各 agent 直接在各自仓库目录并行
- 同仓库多模块 →
- 串行：按依赖顺序逐个推进，前序完成再开后序。
第4步：统一收尾自验证（铁律，必做）
所有 agent 完成后，统一收口：
- 整合：合并 worktree（
git worktree remove）、检查跨任务 import/类型无冲突 - 跑「交付前自验证」：端点路由正确、优雅降级可用、构建/类型通过
- 质量管控（70% AI 任务应用于质检而非功能开发）：可选派 adversarial-review 子agent 多维度挑刺
第5步：规则固化（可选但推荐）
调用 project-ai-rules-setup，把本次验证过的「铁律+技术栈」写入项目 AGENTS.md，
下次并行更稳，避免 AI 在并行时乱改边界外的代码。
对齐的全局铁律
- 技术栈锁定：新项目 Next.js+React+TS+shadcn/ui+Tailwind；智客AI 用 React+Vite+AntD
- 交付前自验证铁律：任何代码产出必须自验后再交
- 页面轻量化铁律：UI 有用、轻、不繁琐
- 默认病种白癜风（本 Skill 不涉及，仅代码开发）
复用引用（本地已有轮子，不重建）
find-wheels-first-methodology→ 第0步开工前找轮子project-ai-rules-setup→ 第5步规则固化郭哥-Skill体系健康巡检/skill-redundancy-auditor→ 本 Skill 建完后的自检通道
反模式（踩了就是倒退）
- ❌ 不拆任务直接让一个 agent 闷头写 → 失去并行提速
- ❌ 高耦合任务强行并行 → 改A炸B、合并爆炸
- ❌ 并行后不统一自验证 → 整合冲突漏网到生产
- ❌ 把本 Skill 当 Expert 用 → 它是执行规程，不是咨询人设