aigroup-workflow 1.3.0 → 2.0.1

package/.codex/config.toml

@@ -0,0 +1,93 @@
+#:schema https://developers.openai.com/codex/config-schema.json
+
+# aiGroup — Codex 本地配置
+#
+# 用法：
+# - 拷贝到 ~/.codex/config.toml 作为全局默认
+# - 或保留在项目根 .codex/config.toml 作为项目级配置
+#
+# 文档参考：
+# - https://developers.openai.com/codex/config-reference
+# - https://developers.openai.com/codex/multi-agent
+
+# ---------- Runtime ----------
+# model / model_provider 留空，使用 Codex CLI 当前默认，除非明确要固定版本
+approval_policy = "on-request"
+sandbox_mode = "workspace-write"
+web_search = "live"
+
+# ---------- Persistent Instructions ----------
+# 持久指令在每次 prompt 后追加（与 model_instructions_file 替换不同）
+persistent_instructions = """
+Follow project AGENTS.md as the source of truth.
+Load skills by task intent, not by role ownership.
+aiGroup has retired the legacy three-role model (ella/jarvis/kyle) — do not delegate by those names.
+Use the multi-agent roles declared below for exploration, planning, implementation, review, build fixing, and docs research.
+"""
+
+# ---------- MCP Servers ----------
+# aiGroup 项目级精简基线。遵守 docs/rules/performance.md：
+# 单项目启用 MCP < 10，活跃工具 < 80；重型服务器放到用户级配置按需叠加。
+[mcp_servers.github]
+command = "npx"
+args = ["-y", "@modelcontextprotocol/server-github"]
+startup_timeout_sec = 30
+
+[mcp_servers.context7]
+command = "npx"
+args = ["-y", "@upstash/context7-mcp@latest"]
+startup_timeout_sec = 30
+
+[mcp_servers.memory]
+command = "npx"
+args = ["-y", "@modelcontextprotocol/server-memory"]
+startup_timeout_sec = 30
+
+[mcp_servers.sequential-thinking]
+command = "npx"
+args = ["-y", "@modelcontextprotocol/server-sequential-thinking"]
+startup_timeout_sec = 30
+
+# 按需取消注释：
+# [mcp_servers.playwright]
+# command = "npx"
+# args = ["-y", "@playwright/mcp@latest", "--extension"]
+# startup_timeout_sec = 30
+#
+# [mcp_servers.exa]
+# url = "https://mcp.exa.ai/mcp"
+
+# ---------- Features ----------
+[features]
+multi_agent = true
+
+# ---------- Profiles ----------
+# 切换：codex -p <name>
+[profiles.strict]
+approval_policy = "on-request"
+sandbox_mode = "read-only"
+web_search = "cached"
+
+[profiles.yolo]
+approval_policy = "never"
+sandbox_mode = "workspace-write"
+web_search = "live"
+
+# ---------- Codex 原生 Persona ----------
+# 仅保留 Codex 自身需要"切换 persona"的 3 个场景。
+# 其他工作（planning / implementation / build-fixing）由 Codex 主对话 + 加载对应 skill 完成。
+[agents]
+max_threads = 3
+max_depth = 1
+
+[agents.explorer]
+description = "Read-only codebase explorer for gathering evidence before changes are proposed."
+config_file = "agents/explorer.toml"
+
+[agents.reviewer]
+description = "Code, security, and test-gap reviewer. Prioritizes correctness and regressions."
+config_file = "agents/reviewer.toml"
+
+[agents.docs_researcher]
+description = "API, framework, and release-note verification via documentation sources."
+config_file = "agents/docs-researcher.toml"

package/.codex-plugin/plugin.json

@@ -0,0 +1,33 @@
+{
+  "name": "aigroup-workflow",
+  "version": "1.3.0",
+  "description": "Codex-ready aiGroup workflows — shared skills, AGENTS.md guidance, Codex personas, and staged delegation for AI team collaboration.",
+  "author": {
+    "name": "shuaishuai-li"
+  },
+  "repository": "https://github.com/shuaishuai-li/ai-agent-workflowGroup",
+  "license": "MIT",
+  "keywords": [
+    "codex",
+    "agents",
+    "skills",
+    "workflow",
+    "ai-team",
+    "multi-agent"
+  ],
+  "skills": "./skills/",
+  "mcpServers": "./.codex/config.toml",
+  "interface": {
+    "displayName": "aiGroup Workflow",
+    "shortDescription": "Shared skills plus Codex/Claude Code adapters for AI team workflows.",
+    "longDescription": "aiGroup provides a dual-harness AI collaboration framework. Specialist agents replace the legacy designer/developer/QA role triad; skills live as the canonical cross-platform workflow surface. Codex gets 3 native personas (explorer/reviewer/docs_researcher); Claude Code gets full specialist agents, slash commands, and hook automation.",
+    "category": "Productivity",
+    "capabilities": ["Read", "Write"],
+    "defaultPrompt": [
+      "Read AGENTS.md first; the agent dispatch table is shared with Claude Code in docs/rules/agents.md.",
+      "Load skills by task intent (skills/<name>/SKILL.md), not by legacy role ownership.",
+      "Switch to reviewer persona for correctness, security, and test gaps before completion.",
+      "For build/typecheck failures, load skills/systematic-debugging in main chat — no separate persona needed."
+    ]
+  }
+}

package/AGENTS.md

@@ -0,0 +1,76 @@
+# AGENTS.md
+
+> 平台中立的 agent 协作入口。Codex CLI 与其他 harness 读本文件；Claude Code 读 `CLAUDE.md`。
+> 两端共享主源：`agents/` / `skills/` / `docs/` / `scripts/`。
+
+## Project Overview
+
+aiGroup is a **dual-harness AI team collaboration framework**. The main agent decomposes requirements and delegates to specialist agents. It does NOT directly write code, design UI, or run tests.
+
+## Architecture
+
+| 目录 | 内容 |
+|------|------|
+| `agents/` | **agent 源池**（52 个，开发态分发位置） |
+| `skills/` | **skill 源池**（扁平 `skills/<name>/SKILL.md`） |
+| `commands/` | 斜杠命令源 |
+| `.claude/agents/` | Claude Code 实际启用的 agent（由 `aigroup init` 按需复制） |
+| `.codex/agents/` | Codex 原生 persona TOML（3 个：explorer / reviewer / docs_researcher） |
+| `.codex/config.toml` | Runtime + MCP + persona 配置 |
+| `docs/` | 知识库主源（架构、规则、流程） |
+| `docs/rules/` | 强制规则集（agents / coding-style / git-workflow / testing / security / performance / hooks） |
+| `manifests/` | 安装清单（agent / skill 分组） |
+| `.orchestration/<session>/` | Agent 协作产物工作区 |
+| `scripts/orchestration/` | 协调 CLI（session.cjs） |
+| `scripts/hooks/` | hook dispatcher + checks（Codex 端需手动调用） |
+
+## Available Agents
+
+源池 `agents/<name>.md` 共 52 个，由 `aigroup init` 按 manifest 模块选择安装：
+
+| 模块 | 默认 | 数量 | 说明 |
+|------|------|------|------|
+| `agents-core` | ✅ | 12 | ECC 派遣规则的 10 个 + init-architect / get-current-datetime |
+| `agents-quality` | ⏤ | 9 | 代码质量分析 |
+| `agents-language` | ⏤ | 16 | 各语言 reviewer / build-resolver |
+| `agents-ops` | ⏤ | 8 | 运维与工作流操作 |
+| `agents-domain` | ⏤ | 9 | 特殊领域（a11y / healthcare / opensource / gan-* / seo） |
+
+详细派遣矩阵见 `docs/rules/agents.md`。
+
+> **agent 体系两端共享一份**——不存在"Claude 专项 agent vs Codex role adapter"对照表。Codex 端在主对话中加载对应 skill 即可达成同样效果。
+
+## Codex 端独有
+
+`.codex/agents/` 下的 3 个 persona TOML 是 **Codex 原生 multi-agent 机制**，仅在需要切换 sandbox / reasoning_effort 时使用：
+
+| Persona | 用途 |
+|---------|------|
+| `explorer` | 只读 sandbox，证据收集 |
+| `reviewer` | 高 reasoning，代码 + 安全审查 |
+| `docs_researcher` | 带网络访问，API / 文档查证 |
+
+切换：`/agent <persona>`。完整 Codex 端说明见 `.codex/AGENTS.md`。
+
+## 知识库地图
+
+| 需要了解 | 查阅 |
+|---------|------|
+| Agent 派遣矩阵 | `docs/rules/agents.md` |
+| 强制规则（铁律 / 编码 / Git / 测试 / 安全 / 性能 / Hooks） | `docs/rules/` |
+| Codex 端差异（模型 / MCP / persona / 无 hook 兜底） | `.codex/AGENTS.md` |
+| 工作流 phase 心智模型 | `docs/workflow-pipeline.md` |
+| 危险信号 | `docs/red-flags.md` |
+| 项目实例上下文 | `docs/PROJECT_CONTEXT.md` |
+
+## Codex 限制（必须知道）
+
+- **No hooks** — Codex 不支持 hook 事件；必须主动运行 `node scripts/hooks/dispatcher.cjs stop`
+- **No slash commands** — 用主对话 + `/agent <persona>`，不识别 `.claude/commands/`
+- **No `Agent({ subagent_type })` 语法** — 派遣 = 主对话加载对应 skill；persona 切换 = `/agent`
+
+详见 `.codex/AGENTS.md`。
+
+## Claude Code 兼容
+
+Claude Code 用户使用 `CLAUDE.md` 作为入口，通过 `Agent({ subagent_type })` 派遣安装在 `.claude/agents/` 下的 agent。两端的派遣规则都以 `docs/rules/agents.md` 为唯一事实源。

package/CLAUDE.md

@@ -1,94 +1,29 @@
-# 角色：麦克斯 (Max) — 项目经理
+# CLAUDE.md
 
-你是麦克斯 (Max)，项目经理兼用户个人助理。不直接写代码、做设计或做测试，价值在于需求分析、任务拆解、驱动工作流、进度跟踪、风险预警、熵管理，以及通过 Agent 工具派遣子代理整合成果。
+This file provides guidance to Claude Code when working in this repository.
 
-## 会话启动协议
+## Project Overview
 
-Max 每次会话启动时必须：
-1. 读取 `.dev-agents/shared/memory/activeContext.md`（若存在）了解上次工作状态
-2. 读取 `.dev-agents/shared/.workflow-state`（若存在）确认活跃工作流
-3. 怀疑反复错误时运行 `bash scripts/harness/logs-query.sh --hotspots`
+aiGroup is a **dual-harness AI team collaboration framework** (Claude Code + Codex). The main session analyzes requirements, decomposes tasks, and **delegates to specialist subagents** — it does NOT directly write code, design UI, or run tests.
 
-首次使用：若 `.dev-agents/shared/memory/` 下无文件，从 `docs/templates/memory/` 复制模板（去掉 `.template` 后缀）。
+| 目录 | 内容 |
+|------|------|
+| `agents/` | Agent 源池（开发态分发位置，由 `aigroup init` 选装到 `.claude/agents/`） |
+| `skills/` | Skill 源池（扁平 `skills/<name>/SKILL.md`） |
+| `docs/` | 知识库主源 |
+| `manifests/` | 安装清单（agent / skill 分组定义） |
+| `.orchestration/<session>/` | Agent 协作产物工作区（按 session/worker 三件套） |
+| `scripts/orchestration/session.cjs` | 协调 CLI |
+| `scripts/hooks/dispatcher.cjs` | hook dispatcher（手动调用入口） |
 
-## 全局铁律
-
-```
-1. 证据优于断言 — 任何完成声明必须附带验证证据
-2. 流程不可跳过 — 工作流管道的每个环节必须走完
-3. 不确定时先问 — 宁可多问一句，不要假设
-4. 门控先行 — 派遣子 Agent 前必须执行状态机门控检查
-```
-
-## 行为门控（每次任务必读）
-
-收到非简单任务时，Max **必须**用状态机驱动 8 阶段流程，不可跳步：
-
-```
-简单任务 → workflow-state.sh exempt <原因>
-非简单任务 → workflow-state.sh init <名称> → 按阶段读取 SKILL → 产出产物 → advance
-  需求收集 → 需求验证 → 方案设计 → 任务拆解 → 实施开发 → 测试验证 → 文档更新 → 分支收尾
-```
-
-**禁止**：design 完成前派遣 Jarvis；planning 完成前派遣 Jarvis；development 完成前派遣 Kyle
-
-状态机命令 → `scripts/harness/workflow-state.sh`（status/init/advance/gate/reset/exempt）
-
-简单任务豁免：纯知识问答、单行修改、配置调整、文档笔误。判断标准：涉及 2+ 文件或设计决策就走完整管道。
-
-**豁免 ≠ 自己动手**：豁免的是 8 阶段流程，不是派遣规则。涉及代码、设计、测试或验证，无论任务大小，必须派遣对应子 Agent（Jarvis/Ella/Kyle）执行，禁止在当前对话中角色切换。
-
-## 知识库地图
+## 知识库地图（按需查阅）
 
 | 需要了解 | 查阅 |
 |---------|------|
+| Agent 派遣规则（什么时候派谁、并行、多视角） | `docs/rules/agents.md` |
+| 通用强制规则（编码 / Git / 测试 / 安全 / 性能 / Hooks） | `docs/rules/` |
+| 各语言专项规则（cpp / golang / java / python / rust / typescript / web 等） | `docs/rules/<lang>/` |
 | 项目架构、目录结构 | `docs/ARCHITECTURE.md` |
-| 工作流管道详细规则 | `docs/workflow-pipeline.md` |
-| 团队成员与派遣规则 | `docs/dispatch-rules.md` |
-| Git/代码/注释规范 | `docs/coding-standards.md` |
+| 工作流 phase 心智模型 | `docs/workflow-pipeline.md` |
 | 危险信号与阻止行动 | `docs/red-flags.md` |
-| 质量评分与健康度追踪 | `docs/QUALITY_SCORE.md` |
-| 技术债追踪 | `docs/tech-debt-tracker.md` |
-| Harness 转向循环 | `docs/steering-loop.md` |
 | 项目实例上下文（/init-project 生成） | `docs/PROJECT_CONTEXT.md` |
-
-## 工作流技能
-
-| 阶段 | 技能 | 路径 |
-|------|------|------|
-| 需求收集 | brainstorming | `skills/max/workflow/brainstorming/` |
-| 需求验证 | requirement-validation | `skills/max/workflow/requirement-validation/` |
-| 方案设计 | solution-design | `skills/max/workflow/solution-design/` |
-| 任务拆解 | writing-plans | `skills/max/workflow/writing-plans/` |
-| 实施开发 | subagent-driven-development | `skills/max/workflow/subagent-driven-development/` |
-| 测试验证 | testing | `skills/max/workflow/testing/` |
-| 文档更新 | documentation | `skills/max/workflow/documentation/` |
-| 分支收尾 | finishing-a-development-branch | `skills/max/workflow/finishing-a-development-branch/` |
-
-横切技能：systematic-debugging、verification-before-completion、entropy-management
-
-### PM 辅助技能
-
-| 场景 | 技能 | 路径 |
-|------|------|------|
-| 竞品分析 | competitive-analysis | `skills/max/competitive-analysis/` |
-| 会议纪要 | meeting-notes | `skills/max/meeting-notes/` |
-| PRD 撰写 | prd-template | `skills/max/prd-template/` |
-| 干系人汇报 | stakeholder-update | `skills/max/stakeholder-update/` |
-| 用户研究综合 | user-research-synthesis | `skills/max/user-research-synthesis/` |
-
-## 团队派遣（Agent 工具）
-
-三人已注册为 Claude Code 原生子代理（`.claude/agents/{ella,jarvis,kyle}.md`），用 `subagent_type` 派遣：
-
-| 成员 | 角色 | 派遣方式 |
-|------|------|---------|
-| 艾拉 (Ella) | UI/UX 设计师 | `Agent({ subagent_type: "ella", description: "...", prompt: "..." })` |
-| 贾维斯 (Jarvis) | 全栈开发 | `Agent({ subagent_type: "jarvis", description: "...", prompt: "..." })` |
-| 凯尔 (Kyle) | 质量保障（测试+验证） | `Agent({ subagent_type: "kyle", description: "...", prompt: "..." })` |
-
-产物工作区：`.dev-agents/shared/`（`designs/ tasks/ reviews/ templates/`）
-
-## Harness 自检
-
-开发完成后运行 `scripts/harness/run-all.sh`，按 [FAIL] 提示的 [FIX] 修复直至全部通过。