aigroup-workflow 2.1.2 → 2.2.0

package/cli/commands/init.mjs

@@ -71,12 +71,26 @@ export async function init(ctx) {
     selectedModules = getDefaultSkillModuleIds(PKG_ROOT)
     log.info(`使用默认 skill 模块：${selectedModules.join(', ')}`)
   } else {
-    const choices = allSkillModules.map(mod => ({
-      name: `${mod.id} — ${mod.description}`,
-      value: mod.id,
-      description: `路径数: ${mod.paths.length} · 成本: ${mod.cost || 'n/a'}`,
-      checked: mod.defaultInstall === true,
-    }))
+    // 按 category 分组排序：流程 (process) → 栈 (stack) → 语言 (language)
+    const CATEGORY_ORDER = { process: 0, stack: 1, language: 2 }
+    const CATEGORY_LABEL = { process: '流程', stack: '栈', language: '语言' }
+    const sorted = [...allSkillModules].sort((a, b) => {
+      const ca = CATEGORY_ORDER[a.category] ?? 99
+      const cb = CATEGORY_ORDER[b.category] ?? 99
+      return ca - cb || a.id.localeCompare(b.id)
+    })
+
+    log.info('skill 按分类细粒度暴露——可独立勾选（如只装 java + quality）')
+    const choices = sorted.map(mod => {
+      const tag = CATEGORY_LABEL[mod.category] || mod.category || ''
+      const tagPart = tag ? `[${tag}] ` : ''
+      return {
+        name: `${tagPart}${mod.id} — ${mod.description}`,
+        value: mod.id,
+        description: `${mod.paths.length} 个 skill · 成本: ${mod.cost || 'n/a'}`,
+        checked: mod.defaultInstall === true,
+      }
+    })
 
     selectedModules = await multiSelect('选择要安装的 skill 模块', choices)
 

package/cli/utils/scaffold.mjs

@@ -7,7 +7,7 @@
  */
 
 import { existsSync, mkdirSync, readdirSync, statSync, readFileSync, writeFileSync, copyFileSync } from 'node:fs'
-import { join, dirname } from 'node:path'
+import { join, dirname, basename } from 'node:path'
 
 // ─── 基础文件（必装） ───
 
@@ -119,6 +119,32 @@ export function getDefaultSkillModuleIds(pkgRoot) {
     .map(m => m.id)
 }
 
+/**
+ * 翻译旧版 skill 模块 id → 新版细粒度 id（基于 manifest.legacyModuleMap）
+ *
+ * 用于兼容历史 .aigroup.json — 老用户配置里写的是 'engineering-languages'
+ * 等聚合 id，新 manifest 已拆成 java/python/javascript/... 等细粒度 id，
+ * 通过本映射在加载时转译，避免老配置升级后丢失模块。
+ */
+export function migrateSkillModuleIds(pkgRoot, ids) {
+  if (!Array.isArray(ids)) return []
+  const manifest = loadManifest(pkgRoot)
+  const map = manifest.legacyModuleMap || {}
+  const validIds = new Set(getSkillModules(pkgRoot).map(m => m.id))
+  const out = new Set()
+  for (const id of ids) {
+    if (validIds.has(id)) {
+      out.add(id)
+    } else if (Array.isArray(map[id])) {
+      for (const newId of map[id]) {
+        if (validIds.has(newId)) out.add(newId)
+      }
+    }
+    // 若既不是有效 id 也无映射，静默忽略（避免 update 报错阻塞）
+  }
+  return [...out]
+}
+
 /**
  * 获取所有 agent 模块（仅 Claude target，含按 agents 列表分组的）
  */
@@ -351,15 +377,16 @@ export function scaffold(pkgRoot, projectRoot, options = {}) {
     let modCopied = 0
     for (const skillPath of mod.paths) {
       const src = join(pkgRoot, skillPath)
-      // skills/<name> → 根据 target 决定落盘位置
-      // Claude target：.claude/skills/<name>（Claude Code 自动加载）
-      // Codex target：skills/<name>（文件路径手动加载）
+      // 源端按分类目录组织（skills/<category>/<name>），落盘端扁平化以保留原 skill ID
+      // Claude target：.claude/skills/<name>/SKILL.md（自动加载，目录名即 skill ID）
+      // Codex target：skills/<name>/SKILL.md（文件路径手动加载，保持扁平兼容旧引用）
+      const skillName = basename(skillPath)
       if (targets.includes('claude')) {
-        const claudeDest = join(projectRoot, skillPath.replace(/^skills\//, '.claude/skills/'))
+        const claudeDest = join(projectRoot, '.claude/skills', skillName)
         modCopied += copyDirRecursive(src, claudeDest, { overwrite })
       }
       if (targets.includes('codex')) {
-        const codexDest = join(projectRoot, skillPath)
+        const codexDest = join(projectRoot, 'skills', skillName)
         modCopied += copyDirRecursive(src, codexDest, { overwrite })
       }
     }
@@ -381,7 +408,9 @@ export function scaffoldUpdate(pkgRoot, projectRoot) {
   let totalCopied = 0
 
   const config = readConfig(projectRoot)
-  const modules = config?.modules || getDefaultSkillModuleIds(pkgRoot)
+  const rawModules = config?.modules || getDefaultSkillModuleIds(pkgRoot)
+  // 翻译旧版聚合 id → 新版细粒度 id，兼容历史 .aigroup.json
+  const modules = migrateSkillModuleIds(pkgRoot, rawModules)
   const targets = config?.targets || ['claude', 'codex']
 
   // 传感器
@@ -441,12 +470,13 @@ export function scaffoldUpdate(pkgRoot, projectRoot) {
     let modCopied = 0
     for (const skillPath of mod.paths) {
       const src = join(pkgRoot, skillPath)
+      const skillName = basename(skillPath)
       if (targets.includes('claude')) {
-        const claudeDest = join(projectRoot, skillPath.replace(/^skills\//, '.claude/skills/'))
+        const claudeDest = join(projectRoot, '.claude/skills', skillName)
         modCopied += copyDirRecursive(src, claudeDest, { overwrite: true })
       }
       if (targets.includes('codex')) {
-        modCopied += copyDirRecursive(src, join(projectRoot, skillPath), { overwrite: true })
+        modCopied += copyDirRecursive(src, join(projectRoot, 'skills', skillName), { overwrite: true })
       }
     }
     sections.push({ name: `skill 模块: ${modId}`, count: modCopied })

package/docs/red-flags.md

@@ -18,7 +18,7 @@
 | 6 | 工作流中有人想跳过关键 phase | 说清楚跳过的理由，让用户确认（phase 按需裁剪，但不能无声跳过） | 🔴 高 | 工作流模式 |
 | 7 | 使用"应该没问题""看起来对了" | 要求提供验证命令和输出证据 | 🟡 中 | 始终 |
 | 8 | 同一类错误反复出现 | 运行 `bash scripts/harness/logs-query.sh --hotspots --days 30` 查看高频失败项 | 🟡 中 | 始终 |
-| 9 | 文档与代码不一致 | 触发 [熵管理](../skills/entropy-management/SKILL.md)，修复漂移 | 🟡 中 | 始终 |
+| 9 | 文档与代码不一致 | 触发 [熵管理](../skills/workflow/entropy-management/SKILL.md)，修复漂移 | 🟡 中 | 始终 |
 | 10 | Harness 传感器长期无告警 | 审查传感器有效性，可能检测不足 | 🟡 中 | 始终 |
 | 11 | 主会话直接写代码/做设计/做测试 | 立即停下，按任务类型派遣专项 agent 执行 | 🔴 高 | 始终 |
 

package/docs/rules/entropy.md

@@ -69,7 +69,7 @@
 
 ## 关联
 
-- `skills/entropy-management/SKILL.md` — 执行流程
+- `skills/workflow/entropy-management/SKILL.md` — 执行流程
 - `agents/refactor-cleaner.md` — 死代码与重复清理
 - `docs/red-flags.md` 信号 #8 / #9 — 反复问题与文档漂移
 - `scripts/hooks/checks/` — 自动化传感器套件

package/docs/rules/performance.md

@@ -13,7 +13,7 @@
 ## Context Hygiene
 
 - 根 `CLAUDE.md` / `AGENTS.md` 只做导航，不复制长篇规则。
-- 完整规则放在 `docs/rules/`，执行方法放在 `skills/<name>/SKILL.md`。
+- 完整规则放在 `docs/rules/`，执行方法放在 `skills/<category>/<name>/SKILL.md`。
 - Agent prompt 只注入任务目标、文件路径、skill 路径、验收条件和验证命令。
 - 不在 prompt 中重复 agent 身份、人格、长背景；这些属于 agent 定义文件。
 

package/docs/workflow-pipeline.md

@@ -2,6 +2,7 @@
 
 > 8 个 phase 是**完整路径上限**，不是强制路径——主会话按任务复杂度和风险**裁剪**。
 > 状态真相源：`.orchestration/<session>/<worker>/status.md`。
+> **完结契约**：worker 转 `completed` 前必须调用 `session.cjs complete` 回写 handoff 标准四节（`Summary` / `Files Changed` / `Validation` / `Follow-ups`），否则视作"未真正完成"。`append` 仅记录过程（设计草稿/需求笔记），不替代 `complete`。
 
 ## 完整路径
 

package/manifests/install-modules.json

@@ -1,30 +1,34 @@
 {
-  "version": 3,
-  "description": "aiGroup 安装清单：agent / skill / commands 模块分组。skill 物理扁平在 skills/<name>/，自动加载；agent 源池在 agents/<name>.md，由 aigroup init 按需选装到 .claude/agents/。模块分类供跨平台插件消费。",
+  "version": 4,
+  "description": "aiGroup 安装清单：skill 模块按物理分类细粒度暴露，CLI 安装时可独立勾选（如只装 java/python/quality）。skill 源端按 skills/<category>/<name>/ 组织，aigroup init 安装时扁平化到目标 .claude/skills/<name>/ 以保留原 skill ID。agent 源池在 agents/<name>.md，由 aigroup init 按需选装到 .claude/agents/。",
+  "legacyModuleMap": {
+    "design": ["frontend"],
+    "engineering-core": ["backend", "database"],
+    "engineering-languages": ["java", "python", "javascript", "go-rust-cpp", "dotnet", "swift", "php", "ruby"],
+    "engineering-infra": ["infra", "ai-ml"]
+  },
   "modules": [
     {
       "id": "workflow",
       "kind": "skills",
-      "description": "跨阶段工作流 skill — 需求工程、规划、调试、审查、worktree、文档、验证、收尾。",
+      "category": "process",
+      "description": "工作流 skill — 需求工程、规划、调试、审查、worktree、文档、验证、收尾、熵管理。",
       "paths": [
-        "skills/requirement-engineering",
-        "skills/brainstorming",
-        "skills/writing-plans",
-        "skills/executing-plans",
-        "skills/using-git-worktrees",
-        "skills/systematic-debugging",
-        "skills/requesting-code-review",
-        "skills/receiving-code-review",
-        "skills/documentation",
-        "skills/verification-before-completion",
-        "skills/finishing-a-development-branch",
-        "skills/writing-skills",
-        "skills/entropy-management"
-      ],
-      "targets": [
-        "claude",
-        "codex"
+        "skills/workflow/requirement-engineering",
+        "skills/workflow/brainstorming",
+        "skills/workflow/writing-plans",
+        "skills/workflow/executing-plans",
+        "skills/workflow/using-git-worktrees",
+        "skills/workflow/systematic-debugging",
+        "skills/workflow/requesting-code-review",
+        "skills/workflow/receiving-code-review",
+        "skills/workflow/documentation",
+        "skills/workflow/verification-before-completion",
+        "skills/workflow/finishing-a-development-branch",
+        "skills/workflow/writing-skills",
+        "skills/workflow/entropy-management"
       ],
+      "targets": ["claude", "codex"],
       "defaultInstall": true,
       "cost": "light",
       "stability": "stable"
@@ -32,150 +36,246 @@
     {
       "id": "product",
       "kind": "skills",
-      "description": "产品管理辅助 skill — PRD、用户研究、竞品、干系人沟通。",
+      "category": "process",
+      "description": "产品管理辅助 skill — PRD、用户研究、竞品、干系人沟通、会议纪要。",
       "paths": [
-        "skills/competitive-analysis",
-        "skills/meeting-notes",
-        "skills/prd-template",
-        "skills/stakeholder-update",
-        "skills/user-research-synthesis"
+        "skills/product/competitive-analysis",
+        "skills/product/meeting-notes",
+        "skills/product/prd-template",
+        "skills/product/stakeholder-update",
+        "skills/product/user-research-synthesis"
       ],
-      "targets": [
-        "claude",
-        "codex"
+      "targets": ["claude", "codex"],
+      "defaultInstall": false,
+      "cost": "light",
+      "stability": "stable"
+    },
+    {
+      "id": "frontend",
+      "kind": "skills",
+      "category": "stack",
+      "description": "前端/UI/UX skill — React/Vue/Angular/Next/Flutter/RN + UI/UX + 设计命令。",
+      "paths": [
+        "skills/frontend/ui-ux-pro-max",
+        "skills/frontend/senior-frontend",
+        "skills/frontend/react-expert",
+        "skills/frontend/vue-expert",
+        "skills/frontend/vue-expert-js",
+        "skills/frontend/angular-architect",
+        "skills/frontend/nextjs-developer",
+        "skills/frontend/flutter-expert",
+        "skills/frontend/react-native-expert",
+        "skills/frontend/design-commands"
       ],
+      "targets": ["claude", "codex"],
       "defaultInstall": false,
+      "cost": "medium",
+      "stability": "stable"
+    },
+    {
+      "id": "backend",
+      "kind": "skills",
+      "category": "stack",
+      "description": "后端核心 skill — API 设计、架构、微服务、GraphQL、调试、重构、全栈守护。任何后端任务的基线。",
+      "paths": [
+        "skills/backend/api-designer",
+        "skills/backend/architecture-designer",
+        "skills/backend/microservices-architect",
+        "skills/backend/graphql-architect",
+        "skills/backend/debugging-wizard",
+        "skills/backend/legacy-modernizer",
+        "skills/backend/fullstack-guardian",
+        "skills/backend/feature-forge",
+        "skills/backend/code-documenter"
+      ],
+      "targets": ["claude", "codex"],
+      "defaultInstall": true,
+      "cost": "medium",
+      "stability": "stable"
+    },
+    {
+      "id": "database",
+      "kind": "skills",
+      "category": "stack",
+      "description": "数据库 skill — SQL 优化、Postgres 专项、数据库优化器。",
+      "paths": [
+        "skills/database/database-optimizer",
+        "skills/database/postgres-pro",
+        "skills/database/sql-pro"
+      ],
+      "targets": ["claude", "codex"],
+      "defaultInstall": true,
       "cost": "light",
       "stability": "stable"
     },
     {
-      "id": "design",
+      "id": "java",
       "kind": "skills",
-      "description": "UI/UX 和前端实现 skill — 设计规范、组件、框架专项。",
+      "category": "language",
+      "description": "Java 生态 — Java 架构、Spring Boot、Kotlin。",
       "paths": [
-        "skills/ui-ux-pro-max",
-        "skills/senior-frontend",
-        "skills/react-expert",
-        "skills/vue-expert",
-        "skills/vue-expert-js",
-        "skills/angular-architect",
-        "skills/nextjs-developer",
-        "skills/flutter-expert",
-        "skills/react-native-expert",
-        "skills/design-commands"
+        "skills/java/java-architect",
+        "skills/java/spring-boot-engineer",
+        "skills/java/kotlin-specialist"
       ],
-      "targets": [
-        "claude",
-        "codex"
+      "targets": ["claude", "codex"],
+      "defaultInstall": false,
+      "cost": "medium",
+      "stability": "stable"
+    },
+    {
+      "id": "python",
+      "kind": "skills",
+      "category": "language",
+      "description": "Python 生态 — Python、FastAPI、Django、Pandas。",
+      "paths": [
+        "skills/python/python-pro",
+        "skills/python/fastapi-expert",
+        "skills/python/django-expert",
+        "skills/python/pandas-pro"
       ],
+      "targets": ["claude", "codex"],
       "defaultInstall": false,
       "cost": "medium",
       "stability": "stable"
     },
     {
-      "id": "engineering-core",
+      "id": "javascript",
       "kind": "skills",
-      "description": "后端核心 skill — API、架构、数据库、调试。任何后端任务的基线。",
+      "category": "language",
+      "description": "JavaScript/TypeScript 生态 — TypeScript、JavaScript、NestJS。",
       "paths": [
-        "skills/api-designer",
-        "skills/architecture-designer",
-        "skills/microservices-architect",
-        "skills/graphql-architect",
-        "skills/database-optimizer",
-        "skills/postgres-pro",
-        "skills/sql-pro",
-        "skills/debugging-wizard",
-        "skills/legacy-modernizer",
-        "skills/fullstack-guardian",
-        "skills/feature-forge",
-        "skills/code-documenter"
+        "skills/javascript/typescript-pro",
+        "skills/javascript/javascript-pro",
+        "skills/javascript/nestjs-expert"
       ],
-      "targets": [
-        "claude",
-        "codex"
+      "targets": ["claude", "codex"],
+      "defaultInstall": false,
+      "cost": "medium",
+      "stability": "stable"
+    },
+    {
+      "id": "go-rust-cpp",
+      "kind": "skills",
+      "category": "language",
+      "description": "系统编程语言 — Go、Rust、C++。",
+      "paths": [
+        "skills/go-rust-cpp/golang-pro",
+        "skills/go-rust-cpp/rust-engineer",
+        "skills/go-rust-cpp/cpp-pro"
       ],
-      "defaultInstall": true,
+      "targets": ["claude", "codex"],
+      "defaultInstall": false,
       "cost": "medium",
       "stability": "stable"
     },
     {
-      "id": "engineering-languages",
+      "id": "dotnet",
       "kind": "skills",
-      "description": "语言/栈专项 skill — 按项目栈按需加载，不默认全装。",
+      "category": "language",
+      "description": ".NET 生态 — C#、.NET Core。",
       "paths": [
-        "skills/typescript-pro",
-        "skills/javascript-pro",
-        "skills/nestjs-expert",
-        "skills/python-pro",
-        "skills/fastapi-expert",
-        "skills/django-expert",
-        "skills/pandas-pro",
-        "skills/golang-pro",
-        "skills/rust-engineer",
-        "skills/cpp-pro",
-        "skills/java-architect",
-        "skills/spring-boot-engineer",
-        "skills/kotlin-specialist",
-        "skills/swift-expert",
-        "skills/php-pro",
-        "skills/laravel-specialist",
-        "skills/rails-expert",
-        "skills/csharp-developer",
-        "skills/dotnet-core-expert"
+        "skills/dotnet/csharp-developer",
+        "skills/dotnet/dotnet-core-expert"
       ],
-      "targets": [
-        "claude",
-        "codex"
+      "targets": ["claude", "codex"],
+      "defaultInstall": false,
+      "cost": "medium",
+      "stability": "stable"
+    },
+    {
+      "id": "swift",
+      "kind": "skills",
+      "category": "language",
+      "description": "Swift 生态 — iOS/macOS 原生开发。",
+      "paths": [
+        "skills/swift/swift-expert"
       ],
+      "targets": ["claude", "codex"],
       "defaultInstall": false,
-      "cost": "heavy",
+      "cost": "light",
       "stability": "stable"
     },
     {
-      "id": "engineering-infra",
+      "id": "php",
       "kind": "skills",
-      "description": "基础设施、DevOps、云、CLI、AI/ML 工程 skill。",
+      "category": "language",
+      "description": "PHP 生态 — PHP、Laravel。",
       "paths": [
-        "skills/devops-engineer",
-        "skills/sre-engineer",
-        "skills/cloud-architect",
-        "skills/kubernetes-specialist",
-        "skills/terraform-engineer",
-        "skills/cli-developer",
-        "skills/mcp-developer",
-        "skills/websocket-engineer",
-        "skills/monitoring-expert",
-        "skills/ml-pipeline",
-        "skills/fine-tuning-expert",
-        "skills/rag-architect",
-        "skills/spark-engineer"
+        "skills/php/php-pro",
+        "skills/php/laravel-specialist"
       ],
-      "targets": [
-        "claude",
-        "codex"
+      "targets": ["claude", "codex"],
+      "defaultInstall": false,
+      "cost": "light",
+      "stability": "stable"
+    },
+    {
+      "id": "ruby",
+      "kind": "skills",
+      "category": "language",
+      "description": "Ruby 生态 — Ruby on Rails。",
+      "paths": [
+        "skills/ruby/rails-expert"
       ],
+      "targets": ["claude", "codex"],
+      "defaultInstall": false,
+      "cost": "light",
+      "stability": "stable"
+    },
+    {
+      "id": "infra",
+      "kind": "skills",
+      "category": "stack",
+      "description": "基础设施 — DevOps、SRE、Cloud、K8s、Terraform、CLI、MCP、WebSocket、监控。",
+      "paths": [
+        "skills/infra/devops-engineer",
+        "skills/infra/sre-engineer",
+        "skills/infra/cloud-architect",
+        "skills/infra/kubernetes-specialist",
+        "skills/infra/terraform-engineer",
+        "skills/infra/cli-developer",
+        "skills/infra/mcp-developer",
+        "skills/infra/websocket-engineer",
+        "skills/infra/monitoring-expert"
+      ],
+      "targets": ["claude", "codex"],
       "defaultInstall": false,
       "cost": "medium",
       "stability": "stable"
     },
     {
-      "id": "quality",
+      "id": "ai-ml",
       "kind": "skills",
-      "description": "审查、测试、安全 skill — 任何交付前的门禁。",
+      "category": "stack",
+      "description": "AI/ML 工程 — ML pipeline、Fine-tuning、RAG、Spark。",
       "paths": [
-        "skills/code-reviewer",
-        "skills/security-reviewer",
-        "skills/secure-code-guardian",
-        "skills/tdd-guide",
-        "skills/test-master",
-        "skills/senior-qa",
-        "skills/playwright-expert",
-        "skills/chaos-engineer"
+        "skills/ai-ml/ml-pipeline",
+        "skills/ai-ml/fine-tuning-expert",
+        "skills/ai-ml/rag-architect",
+        "skills/ai-ml/spark-engineer"
       ],
-      "targets": [
-        "claude",
-        "codex"
+      "targets": ["claude", "codex"],
+      "defaultInstall": false,
+      "cost": "medium",
+      "stability": "stable"
+    },
+    {
+      "id": "quality",
+      "kind": "skills",
+      "category": "process",
+      "description": "审查 / 测试 / 安全 skill — 任何交付前的门禁。",
+      "paths": [
+        "skills/quality/code-reviewer",
+        "skills/quality/security-reviewer",
+        "skills/quality/secure-code-guardian",
+        "skills/quality/tdd-guide",
+        "skills/quality/test-master",
+        "skills/quality/senior-qa",
+        "skills/quality/playwright-expert",
+        "skills/quality/chaos-engineer"
       ],
+      "targets": ["claude", "codex"],
       "defaultInstall": true,
       "cost": "light",
       "stability": "stable"
@@ -198,9 +298,7 @@
         "init-architect",
         "get-current-datetime"
       ],
-      "targets": [
-        "claude"
-      ],
+      "targets": ["claude"],
       "defaultInstall": true,
       "cost": "light",
       "stability": "stable"
@@ -219,9 +317,7 @@
         "silent-failure-hunter",
         "type-design-analyzer"
       ],
-      "targets": [
-        "claude"
-      ],
+      "targets": ["claude"],
       "defaultInstall": false,
       "cost": "medium",
       "stability": "stable"
@@ -247,9 +343,7 @@
         "rust-build-resolver",
         "typescript-reviewer"
       ],
-      "targets": [
-        "claude"
-      ],
+      "targets": ["claude"],
       "defaultInstall": false,
       "cost": "heavy",
       "stability": "stable"
@@ -266,9 +360,7 @@
         "loop-operator",
         "pr-test-analyzer"
       ],
-      "targets": [
-        "claude"
-      ],
+      "targets": ["claude"],
       "defaultInstall": false,
       "cost": "medium",
       "stability": "stable"
@@ -288,9 +380,7 @@
         "opensource-sanitizer",
         "seo-specialist"
       ],
-      "targets": [
-        "claude"
-      ],
+      "targets": ["claude"],
       "defaultInstall": false,
       "cost": "light",
       "stability": "experimental"