aigroup-workflow 1.2.5 → 1.2.7

package/CLAUDE.md

@@ -1,9 +1,6 @@
-# aiGroup - AI 团队协作框架
+# 角色：麦克斯 (Max) — 项目经理
 
-## 角色：麦克斯 (Max) — 项目经理
-
-你是麦克斯 (Max)，项目经理兼用户个人助理。你不直接写代码、做设计或做测试。
-你的价值在于理解需求、驱动工作流、整合成果。
+你是麦克斯 (Max)，项目经理兼用户个人助理。不直接写代码、做设计或做测试，价值在于需求分析、任务拆解、驱动工作流、进度跟踪、风险预警、熵管理，以及通过 Agent 工具派遣子代理整合成果。
 
 ## 全局铁律
 
@@ -24,13 +21,15 @@
   需求收集 → 需求验证 → 方案设计 → 任务拆解 → 实施开发 → 测试验证 → 文档更新 → 分支收尾
 ```
 
-**禁止**：design 完成前派遣 `/jarvis`；planning 完成前派遣 `/jarvis`；development 完成前派遣 `/kyle`
+**禁止**：design 完成前派遣 Jarvis；planning 完成前派遣 Jarvis；development 完成前派遣 Kyle
 
 状态机命令 → `scripts/harness/workflow-state.sh`（status/init/advance/gate/reset/exempt）
 
-## 知识库地图
+简单任务豁免：纯知识问答、单行修改、配置调整、文档笔误。判断标准：涉及 2+ 文件或设计决策就走完整管道。
+
+**豁免 ≠ 自己动手**：豁免的是 8 阶段流程，不是派遣规则。涉及代码、设计、测试或验证，无论任务大小，必须派遣对应子 Agent（Jarvis/Ella/Kyle）执行，禁止在当前对话中角色切换。
 
-> 详细规范均在 `docs/` 目录下，按需检索。本文件仅为入口。
+## 知识库地图
 
 | 需要了解 | 查阅 |
 |---------|------|
@@ -43,18 +42,6 @@
 | 技术债追踪 | `docs/tech-debt-tracker.md` |
 | Harness 转向循环 | `docs/steering-loop.md` |
 
-## 强制工作流管道（8 阶段）
-
-```
-需求收集 → 需求验证 → 方案设计 → 任务拆解 → 实施开发 → 测试验证 → 文档更新 → 分支收尾
-```
-
-详见 → `docs/workflow-pipeline.md`
-
-简单任务豁免：纯知识问答、单行修改、配置调整、文档笔误。判断标准：涉及 2+ 文件或设计决策就走完整管道。
-
-**豁免 ≠ 自己动手**：简单任务豁免的是 8 阶段流程，不是派遣规则。只要涉及代码、设计、测试或验证，无论任务大小，Max **必须派遣对应子 Agent** 执行（Jarvis 写代码、Ella 做设计、Kyle 做测试和代码验证），禁止在当前对话中直接操作。
-
 ## 工作流技能
 
 | 阶段 | 技能 | 路径 |
@@ -82,27 +69,18 @@
 
 ## 团队派遣（Agent 工具）
 
-**Max 必须使用 Agent 工具创建隔离子代理，禁止在当前对话中角色切换。**
+三人已注册为 Claude Code 原生子代理（`.claude/agents/{ella,jarvis,kyle}.md`），用 `subagent_type` 派遣：
 
 | 成员 | 角色 | 派遣方式 |
 |------|------|---------|
-| 艾拉 (Ella) | UI/UX 设计师 | `Agent({ description: "Ella: ...", prompt: "读取 .dev-agents/ella/PERSONA.md ..." })` |
-| 贾维斯 (Jarvis) | 全栈开发 | `Agent({ description: "Jarvis: ...", prompt: "读取 .dev-agents/jarvis/PERSONA.md ..." })` |
-| 凯尔 (Kyle) | 质量保障（测试+验证） | `Agent({ description: "Kyle: ...", prompt: "读取 .dev-agents/kyle/PERSONA.md ..." })` |
-
-详见 → `docs/dispatch-rules.md`
-
-## Harness 传感器
-
-开发完成后，Agent 应运行 `scripts/harness/run-all.sh` 自检。
-传感器覆盖：结构完整性 + 文档健康 + 工作流产物 + **流程合规**
+| 艾拉 (Ella) | UI/UX 设计师 | `Agent({ subagent_type: "ella", description: "...", prompt: "..." })` |
+| 贾维斯 (Jarvis) | 全栈开发 | `Agent({ subagent_type: "jarvis", description: "...", prompt: "..." })` |
+| 凯尔 (Kyle) | 质量保障（测试+验证） | `Agent({ subagent_type: "kyle", description: "...", prompt: "..." })` |
 
-## Harness 转向循环
+产物工作区：`.dev-agents/shared/`（`designs/ tasks/ reviews/ templates/`）
 
-当问题反复出现时，将修复编码为约束（Linter/文档/技能），确保自动执行。详见 → `docs/steering-loop.md`
+## Harness 自检
 
-## Max 的职责边界
+开发完成后运行 `scripts/harness/run-all.sh`，按 [FAIL] 提示的 [FIX] 修复直至全部通过。
 
-- **可以做**：需求分析、任务拆解、驱动工作流、进度跟踪、风险预警、驱动熵管理
-- **不能做**：直接写项目代码、做 UI 设计、做测试验收、做代码验证
-- **铁律**：任何涉及代码/设计/测试/验证的操作，不论任务大小，必须派遣子 Agent（Jarvis/Ella/Kyle）执行
+<!-- aiGroup 框架边界（init-architect 保留区至此，以下由 /init-project 生成） -->

package/README.md

@@ -4,7 +4,7 @@
 [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=flat&colorA=080f12&colorB=1fa669)](LICENSE)
 [![Claude Code](https://img.shields.io/badge/Claude-Code-purple.svg?style=flat&colorA=080f12&colorB=1fa669)](https://claude.ai/code)
 
-> 单入口 AI 团队：一个命令启动，按需自动派遣设计、开发、测试专家。
+> 单入口 AI 团队：Max 指挥官接收需求，按需自动派遣原生子代理（Ella/Jarvis/Kyle）执行。
 > 内置门禁式工作流：需求澄清 → 方案设计 → 实现计划 → 子代理开发 → 两阶段审查 → 分支收尾。
 
 ## 快速开始
@@ -65,7 +65,9 @@ claude
 
 ### 三种使用模式
 
-**模式一：完整管道（复杂任务）**
+**模式一：自然语言描述（推荐）**
+
+直接描述需求即可，Max 会根据任务类型自动调用对应子代理（通过 `Agent({subagent_type: ...})`）：
 
 ```
 你: 帮我做一个用户认证系统
@@ -75,17 +77,28 @@ claude
 → Max 收尾集成
 ```
 
-**模式二：斜杠命令直接派遣（明确任务）**
+**模式二：指定角色派遣（明确意图时）**
+
+在描述中点名角色，Max 会跳过判断直接派遣：
 
 ```
-/ella 设计一个登录页面         # 直接派遣设计师
-/jarvis 实现用户认证 API       # 直接派遣开发
-/kyle 审查用户模块代码          # 直接派遣质量保障
-/init-project 我的项目         # 初始化项目 AI 上下文
-/git-commit                    # 智能 Git 提交
+你: 让 Ella 设计一个登录页面
+你: 找 Jarvis 实现用户认证 API
+你: 请 Kyle 审查用户模块代码
 ```
 
-**模式三：简单问答（轻量任务）**
+子代理身份、门控、技能加载都由 `.claude/agents/<role>.md` 自动注入，Max 无需在 prompt 里重复 PERSONA。
+
+**模式三：项目级斜杠命令（工具类操作）**
+
+```
+/init-project 我的项目         # 初始化项目 AI 上下文（根级+模块级 CLAUDE.md）
+/git-commit                    # 智能 Git 提交（Conventional Commits）
+```
+
+这是仅有的两个保留的 slash 命令——都是项目工具，不是角色派遣。角色派遣统一走 Agent 工具。
+
+**模式四：简单问答（轻量任务）**
 
 ```
 你: 这个项目用的什么技术栈？
@@ -96,23 +109,27 @@ claude
 
 ## 团队成员
 
-| 成员 | 角色 | 技能数 | 负责什么 |
-|------|------|--------|---------|
-| 麦克斯 (Max) | 项目经理 | 16 | 需求分析、任务拆解、进度协调、工作流管道 |
-| 艾拉 (Ella) | UI/UX 设计师 | 10 | 界面设计、交互原型、前端框架参考 |
-| 贾维斯 (Jarvis) | 全栈开发 | 45 | 架构设计、前后端编码、API、DevOps |
-| 凯尔 (Kyle) | 质量保障 | 7 | 代码审查、测试策略、安全审计、E2E |
+三名子代理以 Claude Code **原生子代理**形式定义在 `.claude/agents/`，Max 作为宿主会话通过 Agent 工具调用：
+
+| 成员 | 角色 | 定义位置 | 技能数 | 负责什么 |
+|------|------|---------|--------|---------|
+| 麦克斯 (Max) | 项目经理 | `CLAUDE.md`（宿主会话） | 16 | 需求分析、任务拆解、进度协调、工作流管道 |
+| 艾拉 (Ella) | UI/UX 设计师 | `.claude/agents/ella.md` | 10 | 界面设计、交互原型、前端框架参考 |
+| 贾维斯 (Jarvis) | 全栈开发 | `.claude/agents/jarvis.md` | 45 | 架构设计、前后端编码、API、DevOps |
+| 凯尔 (Kyle) | 质量保障 | `.claude/agents/kyle.md` | 7 | 代码审查、测试策略、安全审计、E2E |
+
+> "Max" 是宿主 Claude 会话的代号，不是独立 agent——所有规则由 `CLAUDE.md` 加载。
+> Ella/Jarvis/Kyle 是**真子代理**，拥有独立 context window、工具集和门控。
 
-## 斜杠命令
+## 可用斜杠命令
 
 | 命令 | 说明 |
 |------|------|
-| `/ella <任务>` | 派遣设计师 — 界面设计、交互原型、设计规范 |
-| `/jarvis <任务>` | 派遣开发 — 编码、技术方案、Bug 修复 |
-| `/kyle <任务>` | 派遣质量保障 — 代码审查、功能验收 |
-| `/init-project <名称>` | 初始化项目 AI 上下文 — 生成根级和模块级 CLAUDE.md 索引 |
+| `/init-project <名称>` | 初始化项目 AI 上下文 — 生成根级和模块级 `CLAUDE.md`，保留 aiGroup 框架 |
 | `/git-commit` | 智能 Git 提交 — 分析变更、生成 Conventional Commits 信息 |
 
+角色派遣**没有专属 slash 命令**——Claude Code 原生机制下，子代理由 `Agent({subagent_type})` 工具调用，触发方式是用户自然语言描述或明确点名角色（见上文"三种使用模式"）。
+
 ## 工作流程
 
 ### 总体协作流程
@@ -150,16 +167,16 @@ sequenceDiagram
     Max->>Max: 分析并拆解任务
 
     Note over Max,Ella: 阶段一 设计
-    Max->>Ella: 派遣设计任务
-    Ella-->>Max: 设计完成
+    Max->>Ella: Agent(subagent_type=ella)
+    Ella-->>Max: 设计完成 + 压缩报告
 
     Note over Max,Jarvis: 阶段二 开发
-    Max->>Jarvis: 派遣开发任务+设计稿路径
-    Jarvis-->>Max: 开发完成
+    Max->>Jarvis: Agent(subagent_type=jarvis) + 设计稿路径
+    Jarvis-->>Max: 开发完成 + 验证证据
 
     Note over Max,Kyle: 阶段三 验收
-    Max->>Kyle: 派遣验收任务+代码路径
-    Kyle-->>Max: 验收完成
+    Max->>Kyle: Agent(subagent_type=kyle) + 代码路径
+    Kyle-->>Max: 两阶段审查结论
 
     Max-->>User: 汇总全流程结果
 ```
@@ -169,21 +186,21 @@ sequenceDiagram
 ```mermaid
 flowchart LR
     subgraph CTX["独立上下文窗口"]
-        MaxCtx["Max\nRules 注入"]
-        EllaCtx["Ella\n独立窗口"]
-        JarvisCtx["Jarvis\n独立窗口"]
-        KyleCtx["Kyle\n独立窗口"]
+        MaxCtx["Max\nCLAUDE.md 注入"]
+        EllaCtx["Ella\n.claude/agents/ella.md"]
+        JarvisCtx["Jarvis\n.claude/agents/jarvis.md"]
+        KyleCtx["Kyle\n.claude/agents/kyle.md"]
     end
 
-    subgraph SHARED["共享产物目录"]
+    subgraph SHARED["共享产物目录 .dev-agents/shared/"]
         Tasks[("tasks/")]
         Designs[("designs/")]
         Reviews[("reviews/")]
     end
 
-    MaxCtx -->|"派遣注入\n需求+产物路径"| EllaCtx
-    MaxCtx -->|"派遣注入\n需求+设计稿路径"| JarvisCtx
-    MaxCtx -->|"派遣注入\n代码路径+需求"| KyleCtx
+    MaxCtx -->|"Agent 派遣\n任务+产物路径"| EllaCtx
+    MaxCtx -->|"Agent 派遣\n任务+设计稿路径"| JarvisCtx
+    MaxCtx -->|"Agent 派遣\n代码路径+规格"| KyleCtx
 
     EllaCtx -->|写入设计稿| Designs
     JarvisCtx -->|读取设计稿| Designs
@@ -195,7 +212,7 @@ flowchart LR
     style KyleCtx fill:#FF9800,color:#fff
 ```
 
-> **关键规则**：子 Agent 之间不能直接通信，所有上下文由 Max 在派遣时注入，跨 Agent 协作通过 `.dev-agents/shared/` 目录下的文件实现。
+> **关键规则**：子代理之间不能直接通信，所有上下文由 Max 在 `Agent` 调用的 prompt 中注入；跨代理协作通过 `.dev-agents/shared/` 目录下的文件实现。子代理身份（PERSONA/门控/技能清单）不需要注入，由 Claude Code 从 agent 定义文件自动加载。
 
 ## 工作流技能（门禁式管道）
 
@@ -237,7 +254,7 @@ Stage 1 不通过 → 修复 → 重审 → 通过后才进入 Stage 2。
 ```mermaid
 flowchart TB
     subgraph MAX["Max 项目经理"]
-        M1["workflow\n8阶段工作流管道"]
+        M1["workflow\n8 阶段工作流管道"]
         M2["PM 辅助技能\n竞品分析/PRD/会议纪要等"]
     end
 
@@ -297,10 +314,13 @@ npx aigroup-workflow init
 
 ```bash
 # 必须复制
-CLAUDE.md                    # Agent 入口
+CLAUDE.md                    # 宿主会话规则（Max 的"宪法"）
 docs/                        # 知识库
-.claude/                     # Claude Code 配置
-.dev-agents/                 # 角色定义 + 协作产物目录
+.claude/agents/              # 原生子代理定义（ella/jarvis/kyle/init-architect/...）
+.claude/commands/            # 工具类斜杠命令（init-project/git-commit）
+.claude/hooks.json           # Hooks 配置
+.claude/settings.json        # 权限配置
+.dev-agents/shared/          # 子代理协作产物目录（空目录结构）
 scripts/harness/             # Harness 传感器
 
 # 按需复制
@@ -322,7 +342,7 @@ bash scripts/harness/run-all.sh
 
 ```
 aiGroup/
-├── CLAUDE.md                  # Agent 入口
+├── CLAUDE.md                  # 宿主会话规则（Max 的"宪法"）
 ├── package.json               # npm 包配置
 ├── bin/aigroup.mjs            # CLI 入口
 ├── cli/                       # CLI 实现
@@ -332,23 +352,23 @@ aiGroup/
 ├── .claude/                   # Claude Code 配置
 │   ├── settings.json          #   权限设置
 │   ├── hooks.json             #   Harness Hooks
-│   └── commands/              #   斜杠命令
-│       ├── ella.md            #     /ella
-│       ├── jarvis.md          #     /jarvis
-│       ├── kyle.md            #     /kyle
-│       ├── init-project.md    #     /init-project
-│       └── git-commit.md      #     /git-commit
-├── .dev-agents/               # 角色定义 + 协作产物
-│   ├── ella/PERSONA.md
-│   ├── jarvis/PERSONA.md
-│   ├── kyle/PERSONA.md
-│   └── shared/                #   tasks/ designs/ reviews/ templates/
+│   ├── commands/              #   工具类斜杠命令
+│   │   ├── init-project.md    #     /init-project
+│   │   └── git-commit.md      #     /git-commit
+│   └── agents/                #   原生子代理定义（Agent({subagent_type}) 调用）
+│       ├── ella.md            #     艾拉（UI/UX 设计师）
+│       ├── jarvis.md          #     贾维斯（全栈开发）
+│       ├── kyle.md            #     凯尔（质量保障）
+│       ├── init-architect.md  #     项目初始化架构师
+│       └── get-current-datetime.md
+├── .dev-agents/shared/        # 角色间协作产物工作区
+│   └── tasks/ designs/ reviews/ templates/
 ├── skills/                    # 技能库（按角色分组）
 │   ├── max/                   #   PM: workflow(11) + 辅助技能(5)
 │   ├── ella/                  #   设计: UI/UX + 前端框架(10)
 │   ├── jarvis/                #   开发: 45 Skills
 │   └── kyle/                  #   QA: 7 Skills
-└── scripts/harness/           # Harness 传感器套件
+└── scripts/harness/           # Harness 传感器套件（5 个传感器）
 ```
 
 ## Harness Engineering
@@ -364,6 +384,16 @@ Agent = Model + Harness
 | **推理型反馈** | AI 审查 | Kyle 两阶段审查 |
 | **熵管理** | 防退化 | entropy-management + 质量评分 |
 
+### 传感器套件（5 个）
+
+| 传感器 | 覆盖 |
+|-------|------|
+| `lint-structure.sh` | 目录结构、核心文件、子代理定义 |
+| `lint-docs.sh` | 文档健康、交叉引用有效性 |
+| `lint-workflow-artifacts.sh` | 工作流产物完整性 |
+| `lint-process.sh` | 流程合规检查 |
+| `lint-delegation.sh` | 派遣契约检查（防止 prompt 重复定义子代理内容） |
+
 ```bash
 bash scripts/harness/run-all.sh   # 全量检查
 ```
@@ -377,12 +407,10 @@ bash scripts/harness/run-all.sh   # 全量检查
 | `aig update` | 增量更新 |
 | `aig check` | 健康检查 |
 | `aig status` | 工作流状态 |
-| `/ella <任务>` | 派遣设计师 |
-| `/jarvis <任务>` | 派遣开发 |
-| `/kyle <任务>` | 派遣 QA |
 | `/init-project <名称>` | 项目 AI 上下文初始化 |
 | `/git-commit` | 智能 Git 提交 |
 
+> 角色派遣无专属 slash 命令——自然语言描述即可，Max 通过 `Agent` 工具自动调用子代理。
 > `aig` 是 `aigroup` 的短别名。npx 用户：`npx aigroup-workflow <命令>`。
 
 ## 致谢

package/cli/commands/update.mjs

@@ -31,13 +31,13 @@ export async function update(ctx) {
   log.dim('将覆盖更新:')
   log.dim('  • scripts/harness/*（传感器脚本）')
   log.dim('  • skills/max/workflow/*（工作流技能）')
-  log.dim('  • .claude/commands/*（子 Agent 命令）')
+  log.dim('  • .claude/commands/*（通用命令）')
+  log.dim('  • .claude/agents/*（原生子代理定义）')
   log.dim('')
   log.dim('不会触碰:')
   log.dim('  • CLAUDE.md（项目入口）')
   log.dim('  • docs/*（知识库文档）')
   log.dim('  • .dev-agents/shared/*（工作产物）')
-  log.dim('  • .dev-agents/*/PERSONA.md（角色定义）')
 
   if (!skipPrompt) {
     const proceed = await confirm('确认更新？', true)

package/cli/utils/scaffold.mjs

@@ -56,31 +56,21 @@ export const HOOKS_FILES = [
   '.claude/agents/get-current-datetime.md',
 ]
 
-/** 角色资产 */
+/** 角色资产（原生子代理：`.claude/agents/{name}.md`） */
 export const AGENT_ASSETS = {
   jarvis: {
     label: '贾维斯 (Jarvis) — 全栈开发工程师',
-    dirs: ['.dev-agents/jarvis'],
-    commands: ['.claude/commands/jarvis.md'],
+    agents: ['.claude/agents/jarvis.md'],
     skills: ['skills/jarvis'],
   },
   ella: {
     label: '艾拉 (Ella) — UI/UX 设计师',
-    dirs: ['.dev-agents/ella'],
-    commands: [
-      '.claude/commands/ella.md',
-      '.claude/commands/ella-design.md',
-      '.claude/commands/ella-handoff.md',
-      '.claude/commands/ella-prototype.md',
-      '.claude/commands/ella-spec.md',
-      '.claude/commands/ella-style.md',
-    ],
+    agents: ['.claude/agents/ella.md'],
     skills: ['skills/ella'],
   },
   kyle: {
     label: '凯尔 (Kyle) — 质量保证工程师',
-    dirs: ['.dev-agents/kyle'],
-    commands: ['.claude/commands/kyle.md'],
+    agents: ['.claude/agents/kyle.md'],
     skills: ['skills/kyle'],
   },
 }
@@ -98,14 +88,9 @@ export const UPDATABLE_DIRS = [
 
 export const UPDATABLE_FILES = [
   '.claude/hooks.json',
-  '.claude/commands/jarvis.md',
-  '.claude/commands/ella.md',
-  '.claude/commands/ella-design.md',
-  '.claude/commands/ella-handoff.md',
-  '.claude/commands/ella-prototype.md',
-  '.claude/commands/ella-spec.md',
-  '.claude/commands/ella-style.md',
-  '.claude/commands/kyle.md',
+  '.claude/agents/jarvis.md',
+  '.claude/agents/ella.md',
+  '.claude/agents/kyle.md',
   '.claude/commands/init-project.md',
   '.claude/commands/git-commit.md',
   '.claude/agents/init-architect.md',
@@ -246,10 +231,7 @@ export function scaffold(pkgRoot, projectRoot, options = {}) {
     if (!agent) continue
     let agentCopied = 0
 
-    for (const dir of agent.dirs) {
-      agentCopied += copyDirRecursive(join(pkgRoot, dir), join(projectRoot, dir), { overwrite })
-    }
-    for (const file of agent.commands) {
+    for (const file of agent.agents) {
       const ok = copySingleFile(join(pkgRoot, file), join(projectRoot, file), overwrite)
       if (ok) agentCopied++
     }
@@ -278,18 +260,19 @@ export function scaffoldUpdate(pkgRoot, projectRoot) {
   }
   sections.push({ name: '工作流技能 + 传感器', count: totalCopied })
 
-  // 更新命令文件（覆盖）
+  // 更新命令/子代理文件（覆盖）
   let cmdCopied = 0
   const config = readConfig(projectRoot)
   const agents = config?.agents || ['jarvis', 'ella', 'kyle']
+  const roleIds = new Set(['jarvis', 'ella', 'kyle'])
   for (const file of UPDATABLE_FILES) {
-    // 只更新用户选择的角色的命令文件
-    const agentId = file.match(/commands\/(\w+)\.md/)?.[1]
-    if (agentId && !agents.includes(agentId)) continue
+    // 角色子代理文件：仅更新用户选中的角色
+    const m = file.match(/agents\/([\w-]+)\.md$/)
+    if (m && roleIds.has(m[1]) && !agents.includes(m[1])) continue
     const ok = copySingleFile(join(pkgRoot, file), join(projectRoot, file), true)
     if (ok) cmdCopied++
   }
-  sections.push({ name: '命令文件', count: cmdCopied })
+  sections.push({ name: '命令/子代理文件', count: cmdCopied })
   totalCopied += cmdCopied
 
   return { totalCopied, sections }

package/docs/ARCHITECTURE.md

@@ -19,15 +19,11 @@ ai-agent-workflowGroup/
 │   ├── QUALITY_SCORE.md       # 质量评分追踪
 │   ├── tech-debt-tracker.md   # 技术债追踪
 │   └── steering-loop.md       # 转向循环机制
-├── .dev-agents/               # Agent 角色与协作产物
-│   ├── ella/PERSONA.md        # 艾拉（UI/UX 设计师）
-│   ├── jarvis/PERSONA.md      # 贾维斯（全栈开发）
-│   ├── kyle/PERSONA.md        # 凯尔（质量保障）
-│   └── shared/                # Agent 间协作产物
-│       ├── tasks/             # 实现计划
-│       ├── designs/           # 设计方案与设计稿
-│       ├── reviews/           # 审查报告
-│       └── templates/         # 文档模板
+├── .dev-agents/shared/        # Agent 间协作产物工作区
+│   ├── tasks/                 # 实现计划
+│   ├── designs/               # 设计方案与设计稿
+│   ├── reviews/               # 审查报告
+│   └── templates/             # 文档模板
 ├── skills/                    # 技能库
 │   ├── max/                   # PM 技能
 │   │   ├── workflow/          # 工作流技能（8 阶段管道 + 横切技能）
@@ -44,7 +40,14 @@ ai-agent-workflowGroup/
 │   └── *.sh                   # 维护脚本
 └── .claude/                   # Claude Code 配置
     ├── settings.json          # 权限配置
-    └── commands/              # 斜杠命令（/ella /jarvis /kyle）
+    ├── hooks.json             # Hook 配置
+    ├── commands/              # 通用斜杠命令（/init-project /git-commit）
+    └── agents/                # 原生子代理定义
+        ├── ella.md            # 艾拉（UI/UX 设计师）
+        ├── jarvis.md          # 贾维斯（全栈开发）
+        ├── kyle.md            # 凯尔（质量保障）
+        ├── init-architect.md  # 项目初始化架构师
+        └── get-current-datetime.md
 ```
 
 ## 核心设计决策

package/docs/dispatch-rules.md

@@ -4,7 +4,7 @@
 
 ```
 ❌ 角色切换（禁止）：
-   Max 在当前对话里读 PERSONA.md 然后"变成" Jarvis 写代码
+   Max 在当前对话里"变成" Jarvis 写代码
    → 这只是同一个 Claude 在角色扮演，没有上下文隔离
 
 ✅ Agent 工具派遣（正确）：
@@ -16,41 +16,33 @@
 
 ## 团队成员
 
-| 成员 | 角色 | PERSONA | 派遣场景 |
-|------|------|---------|---------|
-| 艾拉 (Ella) | UI/UX 设计师 | `.dev-agents/ella/PERSONA.md` | 页面设计、交互原型、设计规范 |
-| 贾维斯 (Jarvis) | 全栈开发 | `.dev-agents/jarvis/PERSONA.md` | 前后端编码、技术方案、Bug 修复 |
-| 凯尔 (Kyle) | 质量保障 | `.dev-agents/kyle/PERSONA.md` | 代码审查、测试验证、安全审计 |
+三人已注册为 Claude Code **原生子代理**，定义文件位于 `.claude/agents/`：
 
-## 派遣方式
+| 成员 | 角色 | 原生子代理 | 派遣场景 |
+|------|------|-----------|---------|
+| 艾拉 (Ella) | UI/UX 设计师 | `.claude/agents/ella.md` | 页面设计、交互原型、设计规范 |
+| 贾维斯 (Jarvis) | 全栈开发 | `.claude/agents/jarvis.md` | 前后端编码、技术方案、Bug 修复 |
+| 凯尔 (Kyle) | 质量保障 | `.claude/agents/kyle.md` | 代码审查、测试验证、安全审计 |
 
-### Max 主动派遣（正规流程）
+## 派遣方式
 
-Max 在工作流管道中驱动时，使用 **Agent 工具** 派遣子代理：
+Max 在工作流管道中驱动时，使用 **Agent 工具的 `subagent_type` 参数** 派遣子代理。子代理定义文件里已包含角色身份、门控检查、技能加载规则和报告规范，无需在 prompt 里重复。
 
 ```
 Agent({
-  description: "[角色]: [任务简述]",
+  subagent_type: "jarvis",                // ella / jarvis / kyle
+  description: "Jarvis: 实现登录接口",
   prompt: "
-先读取 `.dev-agents/[角色]/PERSONA.md` 了解你的角色。
-
-[前置门控检查]
 [任务全文]
-[上下文信息]
+[上下文信息：设计文档路径、实现计划路径等]
 [完成标准]
   "
 })
 ```
 
-### 用户直接派遣（快捷命令）
-
-用户可以直接使用 `/jarvis`、`/ella`、`/kyle` 命令。这些命令会将任务注入当前对话。
-
-**注意**：`/jarvis` 等快捷命令是用户手动使用的。Max 在工作流中派遣时，必须使用 Agent 工具，不是 `/jarvis` 命令。
-
 ## 派遣铁律
 
-1. **Agent 工具派遣** — Max 必须通过 Agent 工具创建隔离子代理
+1. **subagent_type 派遣** — Max 必须通过 `subagent_type` 参数指定角色，禁止用通用 Agent + 读 PERSONA 的老模式
 2. **单一职责** — 设计找艾拉、编码找贾维斯、审查找凯尔，不混派
 3. **可并行则并行** — 独立任务的 Agent 调用可以并行发起
 4. **管道顺序** — 需求收集 → 需求验证 → 方案设计 → 任务拆解 → 开发 → 测试验证 → 文档更新
@@ -63,9 +55,11 @@ Agent 之间不能直接通信。Max 负责在 Agent 工具的 prompt 中注入
 
 | 派遣对象 | prompt 必须注入的内容 |
 |---------|---------------------|
-| Jarvis（开发） | PERSONA 路径 + 门控检查 + 任务全文 + 设计文档路径 + 实现计划路径 |
-| Kyle（审查） | PERSONA 路径 + 门控检查 + 审查规格 + 代码文件路径 + 实现计划路径 |
-| Ella（设计） | PERSONA 路径 + 需求文档 + 现有设计规范 |
+| Jarvis（开发） | 任务全文 + 设计文档路径 + 实现计划路径 |
+| Kyle（审查） | 审查规格 + 代码文件路径 + 实现计划路径 |
+| Ella（设计） | 需求文档 + 现有设计规范 |
+
+> 门控检查、身份定义、技能加载由子代理自身执行，Max 不必重复注入。
 
 ## 产出规范
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aigroup-workflow",
-  "version": "1.2.5",
+  "version": "1.2.7",
   "description": "AI 团队协作框架 — 通过角色派遣、工作流管道和 Harness 传感器驱动 AI 协作开发",
   "type": "module",
   "bin": {