aigroup-workflow 2.2.0 → 2.2.2

package/docs/templates/ui.md

@@ -1,134 +1,134 @@
-# UI 结构化模板
-
-> 将UI设计稿转化为此格式，供前端开发使用
-
----
-
-## META
-```yaml
-页面: [页面名称]
-设计师: [姓名]
-日期: YYYY-MM-DD
-尺寸: [设计稿宽度]px
-链接: [Figma/蓝湖链接]
-```
-
-## 页面结构
-<!-- 用树形结构描述布局 -->
-```
-页面
-├── 头部 (Header)
-│   ├── Logo [左, 120x40]
-│   ├── 导航 [中, flex]
-│   └── 用户信息 [右, 200px]
-├── 主体 (Main)
-│   ├── 侧边栏 [左, 240px, fixed]
-│   └── 内容区 [右, flex]
-└── 底部 (Footer)
-    └── 版权信息 [居中]
-```
-
-## 组件清单
-
-| 组件 | 位置 | 尺寸 | 状态 |
-|------|------|------|------|
-| 按钮-主要 | 表单底部 | 120x40 | default/hover/disabled |
-| 输入框 | 表单 | 100%x40 | default/focus/error |
-| 卡片 | 列表 | 280x160 | default/hover |
-
-## 组件详情
-
-### 按钮-主要
-```yaml
-尺寸: 120x40 | 圆角: 8px
-字体: 16px medium #FFFFFF
-背景: #1890FF
-状态:
-  hover: 背景 #40A9FF
-  disabled: 背景 #D9D9D9, 字色 #999
-```
-
-### 输入框
-```yaml
-尺寸: 100%x40 | 圆角: 4px
-边框: 1px #D9D9D9
-字体: 14px #333
-placeholder: #999
-状态:
-  focus: 边框 #1890FF
-  error: 边框 #FF4D4F, 提示文字下方
-```
-
-## 颜色规范
-```yaml
-主色: #1890FF
-成功: #52C41A
-警告: #FAAD14
-错误: #FF4D4F
-文字:
-  主要: #333333
-  次要: #666666
-  辅助: #999999
-背景:
-  页面: #F5F5F5
-  卡片: #FFFFFF
-```
-
-## 字体规范
-```yaml
-字体: PingFang SC, -apple-system, sans-serif
-标题H1: 24px bold
-标题H2: 20px bold
-正文: 14px regular
-辅助: 12px regular
-```
-
-## 间距规范
-```yaml
-页边距: 24px
-卡片间距: 16px
-组件间距: 12px
-元素间距: 8px
-```
-
-## 交互说明
-
-### 表单提交
-```
-点击提交
-→ 校验失败 → 高亮错误字段 + 显示提示
-→ 校验成功 → 按钮loading → 请求
-  → 成功 → Toast提示 + 跳转
-  → 失败 → Toast错误信息
-```
-
-### 列表加载
-```
-滚动到底部
-→ 显示加载动画
-→ 加载完成追加数据
-→ 无更多数据显示"没有更多了"
-```
-
-## 响应式断点
-```yaml
-PC: >= 1200px
-平板: 768px - 1199px
-手机: < 768px
-```
-
-## 素材清单
-| 名称 | 尺寸 | 格式 | 说明 |
-|------|------|------|------|
-| logo | 120x40 | SVG | 主Logo |
-| icon-xxx | 24x24 | SVG | 图标 |
-
----
-
-<!--
-转换指南:
-1. 截图中的每个区块描述位置+尺寸
-2. 颜色用十六进制，不用"浅蓝色"
-3. 间距用具体像素值
-4. 交互用流程图描述
--->
+# UI 结构化模板
+
+> 将UI设计稿转化为此格式，供前端开发使用
+
+---
+
+## META
+```yaml
+页面: [页面名称]
+设计师: [姓名]
+日期: YYYY-MM-DD
+尺寸: [设计稿宽度]px
+链接: [Figma/蓝湖链接]
+```
+
+## 页面结构
+<!-- 用树形结构描述布局 -->
+```
+页面
+├── 头部 (Header)
+│   ├── Logo [左, 120x40]
+│   ├── 导航 [中, flex]
+│   └── 用户信息 [右, 200px]
+├── 主体 (Main)
+│   ├── 侧边栏 [左, 240px, fixed]
+│   └── 内容区 [右, flex]
+└── 底部 (Footer)
+    └── 版权信息 [居中]
+```
+
+## 组件清单
+
+| 组件 | 位置 | 尺寸 | 状态 |
+|------|------|------|------|
+| 按钮-主要 | 表单底部 | 120x40 | default/hover/disabled |
+| 输入框 | 表单 | 100%x40 | default/focus/error |
+| 卡片 | 列表 | 280x160 | default/hover |
+
+## 组件详情
+
+### 按钮-主要
+```yaml
+尺寸: 120x40 | 圆角: 8px
+字体: 16px medium #FFFFFF
+背景: #1890FF
+状态:
+  hover: 背景 #40A9FF
+  disabled: 背景 #D9D9D9, 字色 #999
+```
+
+### 输入框
+```yaml
+尺寸: 100%x40 | 圆角: 4px
+边框: 1px #D9D9D9
+字体: 14px #333
+placeholder: #999
+状态:
+  focus: 边框 #1890FF
+  error: 边框 #FF4D4F, 提示文字下方
+```
+
+## 颜色规范
+```yaml
+主色: #1890FF
+成功: #52C41A
+警告: #FAAD14
+错误: #FF4D4F
+文字:
+  主要: #333333
+  次要: #666666
+  辅助: #999999
+背景:
+  页面: #F5F5F5
+  卡片: #FFFFFF
+```
+
+## 字体规范
+```yaml
+字体: PingFang SC, -apple-system, sans-serif
+标题H1: 24px bold
+标题H2: 20px bold
+正文: 14px regular
+辅助: 12px regular
+```
+
+## 间距规范
+```yaml
+页边距: 24px
+卡片间距: 16px
+组件间距: 12px
+元素间距: 8px
+```
+
+## 交互说明
+
+### 表单提交
+```
+点击提交
+→ 校验失败 → 高亮错误字段 + 显示提示
+→ 校验成功 → 按钮loading → 请求
+  → 成功 → Toast提示 + 跳转
+  → 失败 → Toast错误信息
+```
+
+### 列表加载
+```
+滚动到底部
+→ 显示加载动画
+→ 加载完成追加数据
+→ 无更多数据显示"没有更多了"
+```
+
+## 响应式断点
+```yaml
+PC: >= 1200px
+平板: 768px - 1199px
+手机: < 768px
+```
+
+## 素材清单
+| 名称 | 尺寸 | 格式 | 说明 |
+|------|------|------|------|
+| logo | 120x40 | SVG | 主Logo |
+| icon-xxx | 24x24 | SVG | 图标 |
+
+---
+
+<!--
+转换指南:
+1. 截图中的每个区块描述位置+尺寸
+2. 颜色用十六进制，不用"浅蓝色"
+3. 间距用具体像素值
+4. 交互用流程图描述
+-->

package/docs/workflow-pipeline.md

@@ -1,8 +1,9 @@
 # 工作流 Phase 心智模型
 
 > 8 个 phase 是**完整路径上限**，不是强制路径——主会话按任务复杂度和风险**裁剪**。
-> 状态真相源：`.orchestration/<session>/<worker>/status.md`。
-> **完结契约**：worker 转 `completed` 前必须调用 `session.cjs complete` 回写 handoff 标准四节（`Summary` / `Files Changed` / `Validation` / `Follow-ups`），否则视作"未真正完成"。`append` 仅记录过程（设计草稿/需求笔记），不替代 `complete`。
+> 状态真相源：`.orchestration/<session>/<worker>/status.json`（`state` 字段）。
+> **完结契约**：worker 转 `completed` 前必须调用 `session.cjs complete` 回写 handoff 标准字段（`summary` / `filesChanged` / `validation` / `followUps`，写入 `finalizedAt` 时间戳），否则视作"未真正完成"。`append` 仅追加过程记录（设计草稿/需求笔记 → `handoff.notes[]`），不替代 `complete`。
+> 产物全部以 JSON 为唯一格式，shape 由 `schemas/orchestration/*.schema.json` 约束；用 `session.cjs validate <session>` 校验。
 
 ## 完整路径
 
@@ -23,12 +24,12 @@
 |---|-------|-----------|--------|---------------------------|---------|
 | 1 | 需求收集 | `brainstorming`（前段） | 主会话 | `architect/requirements.md` | 需求文档包含目标 / 用户场景 / 成功标准 |
 | 2 | 需求验证 | `brainstorming`（中段：challenge） | 主会话 | 在 requirements.md 追加验证结论 | 无歧义、无矛盾、用户确认 |
-| 3 | 方案设计 | `brainstorming`（终段：spec 锁定） | `architect` | `architect/handoff.md`（ADR 格式） | 至少 2 个候选方案 + 推荐理由 |
-| 4 | 任务拆解 | `writing-plans` | `planner` | `planner/handoff.md` | 3–7 个阶段，每个含 agent / 验证命令 |
+| 3 | 方案设计 | `brainstorming`（终段：spec 锁定） | `architect` | `architect/handoff.json`（ADR 格式） | 至少 2 个候选方案 + 推荐理由 |
+| 4 | 任务拆解 | `writing-plans` | `planner` | `planner/handoff.json` | 3–7 个阶段，每个含 agent / 验证命令 |
 | 4→5 桥 | 隔离工作区 | `using-git-worktrees` | 主会话执行 git | session `README.md` 记录 worktree 路径 | worktree 创建、依赖装好、测试基线通过 |
-| 5 | 实施开发 | subagent 派遣（推荐）/ `executing-plans` | `tdd-guide`（TDD 路径）/ 语言专项 reviewer | `<agent>/handoff.md` 或直接改代码 | 改动文件清单 + 验证证据（typecheck / test） |
-| 6a | 审查发起 | `requesting-code-review` | 主会话向 `code-reviewer` 派遣（敏感场景加 `security-reviewer`、关键路径加 `e2e-runner`、按栈加语言专项 reviewer） | `code-reviewer/request.md` | 审查范围 / 验收点 / 关注项清单完整 |
-| 6b | 审查反馈处理 | `receiving-code-review` | 主会话逐条决议 | `code-reviewer/handoff.md`（含决议） | 每条反馈有"采纳/反驳/记录"决议且证据闭环（Stage 1 规格 ✓ Stage 2 代码质量 ✓） |
+| 5 | 实施开发 | Agent Team 派遣（推荐）/ `executing-plans` | `tdd-guide`（TDD 路径）/ 语言专项 agent | `<agent>/handoff.json` 或直接改代码 | 改动文件清单 + 验证证据（typecheck / test） |
+| 6a | 审查发起 | `requesting-code-review` | Review Team：`code-reviewer` + 风险触发的 `security-reviewer` / `e2e-runner` / 语言专项 reviewer | `code-reviewer/request.md` | 审查范围 / 验收点 / 关注项清单完整 |
+| 6b | 审查反馈处理 | `receiving-code-review` | 主会话逐条决议 | `code-reviewer/handoff.json`（含决议） | 每条反馈有"采纳/反驳/记录"决议且证据闭环（`handoff.stages.spec` ✓ `handoff.stages.quality` ✓） |
 | 7 | 文档更新 | （无强制 skill） | `doc-updater` 或主会话直接改 | 直接改 `docs/`；session `README.md` 留笔记 | docs/ARCHITECTURE / docs/PROJECT_CONTEXT / API 文档已同步 |
 | 8 | 分支收尾 | `finishing-a-development-branch` | 主会话 | session `README.md` 总结 | 集成 / PR / 归档 |
 
@@ -64,12 +65,12 @@
 | Checkpoint | 触发位置 | 暂停原因 | orchestrator 行为 |
 |-----------|---------|---------|-----------------|
 | 计划批准 | phase 4 末（`writing-plans` 产出后） | 计划是后续所有 phase 的契约，错误会扩散到实施和审查 | 暂停，向用户展示 plan 摘要，等待"批准 / 修订"回应 |
-| 实施模式选择 | phase 5 起点 | subagent 派遣 vs `executing-plans` 影响代价、速度、上下文清洁度 | 暂停 1 次询问；用户未指定时默认 subagent 派遣并明确告知 |
+| 实施模式选择 | phase 5 起点 | Agent Team 派遣 vs `executing-plans` 影响代价、速度、上下文清洁度 | 暂停 1 次询问；用户未指定时默认 Agent Team 派遣并明确告知 |
 | 集成方式选择 | phase 8（`finishing-a-development-branch` Step 3） | merge / PR / keep / discard 是不可逆的对外操作 | 暂停展示 4 选项，不替用户选 |
 | Discard 确认 | phase 8 选项 4 | 删除分支 + worktree 不可恢复 | 必须用户键入 `discard` 字面量；其他输入一律视为放弃 |
 | 审查反馈分歧 | phase 6b（`receiving-code-review` 中） | reviewer 与实施 agent 对同一问题给出冲突结论时 | 暂停，把分歧摘要呈给用户决议 |
 
-**自动决策**（不打断用户）：phase 间流转、handoff 文件生成、`status.md` 推进、worktree 路径分配、`session.cjs` 状态写入、phase 内的子 agent 派遣。
+**自动决策**（不打断用户）：phase 间流转、handoff 文件生成、`status.json` 推进、worktree 路径分配、`session.cjs` 状态写入、phase 内的 Agent Team 派遣。
 
 ## Session 存在条件
 
@@ -80,7 +81,7 @@
 - 有明确验收标准、需追溯证据链
 - ≥2 个 worker 产生 handoff
 
-不满足以上条件 → 不建 session。直接走主对话或单 agent 轻量命令（`/plan` / `/review` / `/fix-build` / `/tdd`）。
+不满足以上条件 → 不建 session。直接走主对话或最小团队轻量命令（`/plan` / `/review` / `/fix-build` / `/tdd`）。
 
 主会话识别出复杂任务时，应**建议**启动 session 而非强制。
 

package/package.json

@@ -1,39 +1,40 @@
-{
-  "name": "aigroup-workflow",
-  "version": "2.2.0",
-  "description": "AI 团队协作框架 — 通过角色派遣、工作流管道和 Harness 传感器驱动 AI 协作开发",
-  "type": "module",
-  "bin": {
-    "aigroup": "bin/aigroup.mjs",
-    "aig": "bin/aigroup.mjs"
-  },
-  "files": [
-    "bin/",
-    "cli/",
-    "docs/",
-    "agents/",
-    "skills/",
-    "scripts/",
-    "manifests/",
-    ".claude/commands/",
-    ".claude/hooks.json",
-    ".claude-plugin/",
-    ".codex/",
-    ".codex-plugin/",
-    "CLAUDE.md",
-    "AGENTS.md"
-  ],
-  "keywords": [
-    "claude-code",
-    "ai-agent",
-    "workflow",
-    "harness",
-    "cli"
-  ],
-  "author": "shuaishuai-li",
-  "license": "MIT",
-  "engines": {
-    "node": ">=18.0.0"
-  },
-  "dependencies": {}
-}
+{
+  "name": "aigroup-workflow",
+  "version": "2.2.2",
+  "description": "AI 团队协作框架 — 通过角色派遣、工作流管道和 Harness 传感器驱动 AI 协作开发",
+  "type": "module",
+  "bin": {
+    "aigroup": "bin/aigroup.mjs",
+    "aig": "bin/aigroup.mjs"
+  },
+  "files": [
+    "bin/",
+    "cli/",
+    "docs/",
+    "agents/",
+    "skills/",
+    "scripts/",
+    "manifests/",
+    ".claude/commands/",
+    ".claude/settings.json",
+    ".claude/hooks.json",
+    ".claude-plugin/",
+    ".codex/",
+    ".codex-plugin/",
+    "CLAUDE.md",
+    "AGENTS.md"
+  ],
+  "keywords": [
+    "claude-code",
+    "ai-agent",
+    "workflow",
+    "harness",
+    "cli"
+  ],
+  "author": "shuaishuai-li",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {}
+}

package/scripts/hooks/checks/orchestration-artifacts.cjs

@@ -5,8 +5,14 @@ const path = require('path');
 const { createReport, ROOT, relPosix, dirExists } = require('../lib/runner.cjs');
 
 const COORD_ROOT = path.join(ROOT, '.orchestration');
-const STAGE1_RE = /(stage.?1|阶段.?1|规格符合)/i;
-const STAGE2_RE = /(stage.?2|阶段.?2|代码质量)/i;
+
+function readJsonSafe(filePath) {
+  try {
+    return JSON.parse(fs.readFileSync(filePath, 'utf8'));
+  } catch (_error) {
+    return null;
+  }
+}
 
 function run() {
   const report = createReport();
@@ -22,37 +28,36 @@ function run() {
 
     for (const worker of workers) {
       const workerDir = path.join(sessionDir, worker.name);
-      const statusFile = path.join(workerDir, 'status.md');
-
-      // 轻量 worker：只要求 handoff + status，跳过 task.md
-      let lightweight = false;
-      try {
-        const raw = fs.readFileSync(statusFile, 'utf8');
-        lightweight = /^\s*-\s*Lightweight:\s*true/m.test(raw);
-      } catch (_error) { /* fall through */ }
+      const statusFile = path.join(workerDir, 'status.json');
+      const handoffFile = path.join(workerDir, 'handoff.json');
+      const taskFile = path.join(workerDir, 'task.json');
 
-      const required = lightweight
-        ? ['handoff.md', 'status.md']
-        : ['task.md', 'handoff.md', 'status.md'];
+      // JSON 化后所有 worker 三件套统一：task + handoff + status 都必须存在。
+      // 轻量与否通过 task.lightweight / status.lightweight 字段区分，不再靠文件缺失。
+      const required = [
+        ['task.json', taskFile],
+        ['handoff.json', handoffFile],
+        ['status.json', statusFile]
+      ];
 
-      for (const file of required) {
-        const full = path.join(workerDir, file);
+      for (const [name, full] of required) {
         if (!fs.existsSync(full)) {
           report.fail(
-            `${relPosix(workerDir)}/ 缺失 ${file}${lightweight ? '（轻量 worker）' : ''}`,
-            '用 node scripts/orchestration/session.cjs add-worker 创建（轻量加 --lightweight）'
+            `${relPosix(workerDir)}/ 缺失 ${name}`,
+            '用 `node scripts/orchestration/session.cjs add-worker` 创建（轻量加 --lightweight）'
           );
         }
       }
 
+      // code-reviewer 强制双阶段产物
       if (worker.name === 'code-reviewer') {
-        const handoff = path.join(workerDir, 'handoff.md');
-        if (fs.existsSync(handoff)) {
-          const content = fs.readFileSync(handoff, 'utf8');
-          if (!STAGE1_RE.test(content) && !STAGE2_RE.test(content)) {
+        const handoff = readJsonSafe(handoffFile);
+        if (handoff && handoff.finalizedAt) {
+          const stages = handoff.stages || {};
+          if (!stages.spec || !stages.quality) {
             report.fail(
-              `${relPosix(handoff)} 缺少阶段标识`,
-              '审查报告必须含 Stage 1 (规格符合性) 和 Stage 2 (代码质量)'
+              `${relPosix(handoffFile)} 缺少双阶段产物`,
+              '审查报告必须填 handoff.stages.spec (Stage 1 规格符合性) + handoff.stages.quality (Stage 2 代码质量)；用 `--stage-spec`/`--stage-quality` 传给 complete 命令'
             );
           }
         }

package/scripts/hooks/checks/workflow-state.cjs

@@ -4,7 +4,7 @@ const fs = require('fs');
 const path = require('path');
 const { createReport, ROOT, relPosix, dirExists } = require('../lib/runner.cjs');
 
-// 真相源：.orchestration/<session>/<worker>/status.md
+// 真相源：.orchestration/<session>/<worker>/status.json (state 字段)
 // 在 Stop 事件中：若任一 worker state=running，说明主会话要停但 worker 没走到终态。
 // 终态：completed | failed | blocked （完成、失败、主动阻塞都允许 Stop）
 
@@ -12,9 +12,8 @@ const TERMINAL_STATES = new Set(['completed', 'failed', 'blocked']);
 
 function readState(statusFile) {
   try {
-    const content = fs.readFileSync(statusFile, 'utf8');
-    const match = content.match(/^\s*-\s*State:\s*(\S+)/m);
-    return match ? match[1].toLowerCase() : null;
+    const data = JSON.parse(fs.readFileSync(statusFile, 'utf8'));
+    return typeof data.state === 'string' ? data.state.toLowerCase() : null;
   } catch (_error) {
     return null;
   }
@@ -35,7 +34,7 @@ function run() {
       .filter(entry => entry.isDirectory());
 
     for (const worker of workers) {
-      const statusFile = path.join(sessionDir, worker.name, 'status.md');
+      const statusFile = path.join(sessionDir, worker.name, 'status.json');
       const state = readState(statusFile);
       if (state === 'running') {
         stuck.push(relPosix(statusFile));