aigroup-workflow 1.1.1 → 1.1.2

package/.claude/commands/git-commit.md

@@ -0,0 +1,61 @@
+你是麦克斯 (Max)，项目经理。现在需要创建一个 Git 提交。
+
+## 任务
+
+$ARGUMENTS
+
+## 执行步骤
+
+### 1. 检查变更
+
+```bash
+git status
+git diff --stat
+```
+
+### 2. 分析变更内容
+
+查看所有变更的文件，理解改动的性质：
+- 新功能 (feat)
+- Bug 修复 (fix)
+- 重构 (refactor)
+- 文档 (docs)
+- 配置/构建 (chore)
+- 样式调整 (style)
+- 测试 (test)
+
+### 3. 生成提交信息
+
+遵循 Conventional Commits 规范：
+
+```
+<type>(<scope>): <简短中文描述>
+
+<详细说明（可选）>
+```
+
+**规则**：
+- type 使用英文（feat/fix/refactor/docs/chore/style/test）
+- scope 根据改动范围填写（模块名/文件名）
+- 描述使用中文，简洁明确
+- 不超过 72 字符
+
+### 4. 执行提交
+
+```bash
+git add <相关文件>
+git commit -m "<生成的提交信息>"
+```
+
+**注意**：
+- 只添加相关变更文件，不要 `git add .`
+- 不要添加 .env、credentials 等敏感文件
+- 如果变更涉及多个不相关的功能，拆分为多次提交
+- 提交前确认没有遗漏的文件
+
+### 5. 输出
+
+报告：
+1. 提交的文件列表
+2. 提交信息
+3. 提交哈希

package/.claude/commands/init-project.md

@@ -0,0 +1,83 @@
+---
+description: 初始化项目 AI 上下文，生成/更新根级与模块级 CLAUDE.md 索引
+argument-hint: <项目摘要或名称>
+---
+
+## 用法
+
+`/init-project <项目摘要或名称>`
+
+## 目标
+
+以"根级简明 + 模块级详尽"的混合策略初始化项目 AI 上下文：
+
+- 在仓库根生成/更新 `CLAUDE.md`（高层愿景、架构总览、模块索引、全局规范）。
+- 在识别的各模块目录生成/更新本地 `CLAUDE.md`（接口、依赖、入口、测试、关键文件等）。
+- 为根 `CLAUDE.md` 自动生成 Mermaid 结构图，并为每个模块 `CLAUDE.md` 添加导航面包屑。
+
+## 执行步骤
+
+### 步骤 1：全仓清点（轻量）
+
+快速统计文件与目录，识别模块根：
+- 查找 `package.json`、`pyproject.toml`、`go.mod`、`pom.xml`、`build.gradle` 等项目标识
+- 识别模块目录：`apps/*`、`packages/*`、`services/*`、`src/modules/*` 等
+- 统计文件数量和目录结构
+- 识别技术栈（语言、框架、构建工具）
+
+### 步骤 2：模块优先扫描（中等）
+
+对每个模块做定点读取与样本抽取：
+- **入口文件**：`index.*`、`main.*`、`app.*`
+- **接口/API**：路由定义、控制器、GraphQL schema
+- **依赖**：`import`/`require` 语句分析，模块间引用关系
+- **测试**：测试文件和覆盖率配置
+- **数据模型**：实体定义、数据库 schema、类型声明
+- **质量工具**：ESLint、Prettier、TypeScript 配置
+
+### 步骤 3：生成/更新 CLAUDE.md
+
+**根级 `CLAUDE.md`** 包含：
+- 项目愿景和简介（基于 $ARGUMENTS）
+- 技术栈总览
+- Mermaid 架构图
+- 模块索引（名称 + 路径 + 一句话职责）
+- 全局编码规范和约定
+- 常用命令速查
+
+**模块级 `<module>/CLAUDE.md`** 包含：
+- 导航面包屑（`← 返回根 CLAUDE.md`）
+- 模块职责描述
+- 关键文件和入口
+- 公开接口/API
+- 依赖关系（上游和下游）
+- 测试说明
+
+### 步骤 4：aiGroup 框架适配
+
+如果项目已安装 aiGroup 框架（存在 `.dev-agents/`）：
+- 更新 `docs/ARCHITECTURE.md` 为实际架构
+- 根据技术栈推荐 Jarvis 优先加载的技能
+- 运行 `bash scripts/harness/run-all.sh` 健康检查
+
+## 覆盖率与增量更新
+
+- 输出"已扫描文件数 / 估算总文件数"和"已覆盖模块占比"
+- 列出被忽略/跳过的原因和"建议下一步深挖的子路径"
+- 重复运行 `/init-project` 时做**增量更新**与**断点续扫**，不覆盖用户自定义内容
+
+## 安全与边界
+
+- 只读/写文档与索引，**不改源代码**
+- 默认忽略 `node_modules`、`dist`、`build`、`.git`、二进制文件等生成物
+- 结果在主对话打印摘要，全文写入仓库
+
+## 输出要求
+
+在主对话中打印"初始化结果摘要"：
+1. 根级 `CLAUDE.md` 是否创建/更新、主要栏目概览
+2. 识别的模块数量及路径列表
+3. 每个模块 `CLAUDE.md` 的生成/更新情况
+4. 已生成 Mermaid 结构图和导航面包屑数量
+5. 覆盖率与主要缺口
+6. 若未读全：说明原因，并列出推荐的下一步

package/.claude/commands/jarvis.md

@@ -37,9 +37,12 @@ $ARGUMENTS
 
 1. **必读** → `skills/kyle/tdd-guide/SKILL.md`（TDD 工作流和测试模式）
 2. **必读** → `skills/max/workflow/verification-before-completion/SKILL.md`（完成验证规范）
-3. **按需** → `skills/jarvis/engineering-team/SKILL.md`（工程团队开发规范，涉及后端/全栈时读取）
-4. **按需** → `skills/jarvis/claude-simone/CLAUDE.md`（开发框架参考）
-5. **Bug 修复时** → `skills/max/workflow/systematic-debugging/SKILL.md`
+3. **按需** → `skills/jarvis/fullstack-guardian/SKILL.md`（全栈安全开发，涉及前后端集成时读取）
+4. **按需** → `skills/jarvis/api-designer/SKILL.md`（API 设计，涉及 REST/GraphQL 时读取）
+5. **按需** → `skills/jarvis/architecture-designer/SKILL.md`（系统架构设计，涉及架构决策时读取）
+6. **Bug 修复时** → `skills/max/workflow/systematic-debugging/SKILL.md`
+
+完整技能列表见 `.dev-agents/jarvis/PERSONA.md` 的技能加载表，根据任务类型按需读取 1-3 个最相关的 SKILL.md。
 
 ## 工作规范
 

package/README.md

@@ -1,5 +1,9 @@
 # aiGroup - AI 团队协作框架
 
+[![npm version](https://img.shields.io/npm/v/aigroup-workflow?style=flat&colorA=080f12&colorB=1fa669)](https://npmjs.com/package/aigroup-workflow)
+[![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 团队：一个命令启动，按需自动派遣设计、开发、测试专家。
 > 内置门禁式工作流：需求澄清 → 方案设计 → 实现计划 → 子代理开发 → 两阶段审查 → 分支收尾。
 
@@ -9,20 +13,20 @@
 
 | 依赖 | 最低版本 | 用途 |
 |------|---------|------|
-| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | 最新版 | AI Agent 运行时（主要使用方式） |
-| [Cursor](https://cursor.com) | 最新版 | AI IDE（可选，替代使用方式） |
-| Node.js | 18+ | CLI 工具运行 |
+| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | 最新版 | AI Agent 运行时（推荐） |
+| [Cursor](https://cursor.com) | 最新版 | AI IDE（可选） |
+| Node.js | 18+ | CLI 工具 |
 | Git | 2.x | 版本控制 |
-| Bash | 4.x+ | Harness 传感器脚本（Windows 用户可用 Git Bash） |
+| Bash | 4.x+ | Harness 传感器（Windows 用 Git Bash） |
 
 ### 安装
 
 ```bash
-# 方式一：通过 npm 安装 CLI（推荐）
+# 方式一：全局安装（推荐，安装后可直接用 aig 命令）
 npm install -g aigroup-workflow
-aigroup init
+aig init
 
-# 方式二：npx 免安装使用
+# 方式二：npx 免安装
 npx aigroup-workflow init
 
 # 方式三：克隆仓库
@@ -33,18 +37,22 @@ cd ai-agent-workflowGroup
 ### CLI 命令
 
 ```bash
-aigroup init          # 交互式初始化（选择角色、安装技能和配置）
-aigroup update        # 增量更新（只更新技能和传感器，不覆盖自定义）
-aigroup check         # 运行 Harness 健康检查
-aigroup status        # 查看工作流状态
-aigroup init --yes    # 跳过确认，使用默认配置
+aig                   # 交互式主菜单（无参数启动）
+aig init              # 初始化（交互式选择角色和技能）
+aig init --yes        # 跳过确认，使用默认配置
+aig update            # 增量更新（不覆盖自定义配置）
+aig check             # Harness 健康检查
+aig status            # 工作流状态
+aig help              # 帮助
 ```
 
-`init` 命令支持交互式多选：使用 **方向键** 移动光标，**空格** 切换选中角色，**回车** 确认。
+> `aig` 是 `aigroup` 的短别名，两者等效。npx 用户使用 `npx aigroup-workflow <命令>`。
+
+`init` 命令支持 inquirer 风格交互：**方向键** 移动、**空格** 切换选中、**a** 全选、**回车** 确认。
 
 ### 启动
 
-**Claude Code 中使用（推荐）：**
+**Claude Code（推荐）：**
 
 ```bash
 cd your-project
@@ -53,16 +61,12 @@ claude
 
 启动后 Max 自动就位，读取 `CLAUDE.md` 作为入口，根据你的需求驱动整个团队。
 
-**Cursor 中使用：**
-
-直接用 Cursor 打开项目目录，Agent 会自动读取 `CLAUDE.md` 获取框架规则。
+**Cursor：** 直接打开项目目录，Agent 自动读取 `CLAUDE.md`。
 
 ### 三种使用模式
 
 **模式一：完整管道（复杂任务）**
 
-直接描述需求，Max 自动驱动完整管道：
-
 ```
 你: 帮我做一个用户认证系统
 → Max 启动 brainstorming，逐步澄清需求
@@ -73,18 +77,16 @@ claude
 
 **模式二：斜杠命令直接派遣（明确任务）**
 
-跳过 Max 调度，直接派遣指定成员：
-
 ```
 /ella 设计一个登录页面         # 直接派遣设计师
 /jarvis 实现用户认证 API       # 直接派遣开发
 /kyle 审查用户模块代码          # 直接派遣质量保障
+/init-project 我的项目         # 初始化项目 AI 上下文
+/git-commit                    # 智能 Git 提交
 ```
 
 **模式三：简单问答（轻量任务）**
 
-不涉及设计决策的简单问题，Max 直接回答：
-
 ```
 你: 这个项目用的什么技术栈？
 → Max 直接回答，不启动管道
@@ -94,12 +96,22 @@ claude
 
 ## 团队成员
 
-| 成员             | 角色          | 负责什么                         | 不负责什么         |
-|------------------|---------------|----------------------------------|--------------------|
-| 麦克斯 (Max)     | 项目经理      | 需求分析、任务拆解、进度协调     | 写代码、做设计、做测试 |
-| 艾拉 (Ella)      | UI/UX 设计师  | 界面设计、交互原型、设计规范     | 写代码、做测试     |
-| 贾维斯 (Jarvis)  | 全栈开发      | 前后端编码、API、技术方案        | 做设计、做测试验收 |
-| 凯尔 (Kyle)      | 质量保障      | 代码审查、功能验收、安全审计     | 写代码、做设计     |
+| 成员 | 角色 | 技能数 | 负责什么 |
+|------|------|--------|---------|
+| 麦克斯 (Max) | 项目经理 | 16 | 需求分析、任务拆解、进度协调、工作流管道 |
+| 艾拉 (Ella) | UI/UX 设计师 | 10 | 界面设计、交互原型、前端框架参考 |
+| 贾维斯 (Jarvis) | 全栈开发 | 45 | 架构设计、前后端编码、API、DevOps |
+| 凯尔 (Kyle) | 质量保障 | 7 | 代码审查、测试策略、安全审计、E2E |
+
+## 斜杠命令
+
+| 命令 | 说明 |
+|------|------|
+| `/ella <任务>` | 派遣设计师 — 界面设计、交互原型、设计规范 |
+| `/jarvis <任务>` | 派遣开发 — 编码、技术方案、Bug 修复 |
+| `/kyle <任务>` | 派遣质量保障 — 代码审查、功能验收 |
+| `/init-project <名称>` | 初始化项目 AI 上下文 — 生成根级和模块级 CLAUDE.md 索引 |
+| `/git-commit` | 智能 Git 提交 — 分析变更、生成 Conventional Commits 信息 |
 
 ## 工作流程
 
@@ -124,32 +136,6 @@ flowchart TD
     Summary --> Done(["反馈给用户"])
 ```
 
-### 任务派遣决策流程
-
-```mermaid
-flowchart TD
-    Input(["用户输入"]) --> Parse["Max 解析需求"]
-    Parse --> Classify{"需求分类"}
-
-    Classify -->|"界面/交互/视觉"| Design["设计需求"]
-    Classify -->|"编码/功能/API/修复"| Dev["开发需求"]
-    Classify -->|"审查/验收/测试"| QA["质量需求"]
-    Classify -->|"咨询/解释"| Simple["简单问题"]
-
-    Design --> Clarify1{"需求清晰?"}
-    Clarify1 -->|否| Ask1["追问澄清"] --> Clarify1
-    Clarify1 -->|是| GoElla["派遣 Ella"]
-
-    Dev --> Clarify2{"需求清晰?"}
-    Clarify2 -->|否| Ask2["追问澄清"] --> Clarify2
-    Clarify2 -->|是| HasDesign{"有设计稿?"}
-    HasDesign -->|是| GoJarvis1["派遣 Jarvis + 设计稿路径"]
-    HasDesign -->|否| GoJarvis2["派遣 Jarvis + 技术上下文"]
-
-    QA --> GoKyle["派遣 Kyle + 代码路径"]
-    Simple --> MaxAnswer["Max 直接回答"]
-```
-
 ### 完整流水线
 
 ```mermaid
@@ -159,32 +145,20 @@ sequenceDiagram
     participant Ella
     participant Jarvis
     participant Kyle
-    participant Shared
 
     User->>Max: 提出需求
     Max->>Max: 分析并拆解任务
 
     Note over Max,Ella: 阶段一 设计
     Max->>Ella: 派遣设计任务
-    Ella->>Shared: 输出设计稿
     Ella-->>Max: 设计完成
-    Max-->>User: 需要开发吗
-
-    User->>Max: 确认开发
 
     Note over Max,Jarvis: 阶段二 开发
     Max->>Jarvis: 派遣开发任务+设计稿路径
-    Jarvis->>Shared: 读取设计稿
-    Jarvis->>Jarvis: 实现代码
     Jarvis-->>Max: 开发完成
-    Max-->>User: 需要验收吗
-
-    User->>Max: 确认验收
 
     Note over Max,Kyle: 阶段三 验收
     Max->>Kyle: 派遣验收任务+代码路径
-    Kyle->>Kyle: 代码审查+功能验收
-    Kyle->>Shared: 输出审查报告
     Kyle-->>Max: 验收完成
 
     Max-->>User: 汇总全流程结果
@@ -214,7 +188,6 @@ flowchart LR
     EllaCtx -->|写入设计稿| Designs
     JarvisCtx -->|读取设计稿| Designs
     KyleCtx -->|写入审查报告| Reviews
-    MaxCtx -->|写入任务文档| Tasks
 
     style MaxCtx fill:#4A90D9,color:#fff
     style EllaCtx fill:#E91E63,color:#fff
@@ -224,57 +197,30 @@ flowchart LR
 
 > **关键规则**：子 Agent 之间不能直接通信，所有上下文由 Max 在派遣时注入，跨 Agent 协作通过 `.dev-agents/shared/` 目录下的文件实现。
 
-### 并行与串行
-
-```mermaid
-flowchart TD
-    User(["用户: 多个任务"]) --> Max["Max 分析"]
-    Max --> Check{"任务间有依赖?"}
-
-    Check -->|无依赖| Parallel["并行派遣"]
-    Parallel --> P1["Ella: 设计登录页"]
-    Parallel --> P2["Jarvis: 开发后端 API"]
-    P1 --> Merge["Max 汇总"]
-    P2 --> Merge
-
-    Check -->|有依赖| Sequential["串行执行"]
-    Sequential --> S1["先: Ella 出设计稿"]
-    S1 --> S2["后: Jarvis 按稿开发"]
-    S2 --> Merge2["Max 汇总"]
-```
-
 ## 工作流技能（门禁式管道）
 
-受 [Superpowers](https://github.com/obra/superpowers) 和 [Harness Engineering](https://martinfowler.com/articles/harness-engineering.html) 启发，aiGroup 内置工作流技能，形成严格的门禁管道——每个环节必须完成才能进入下一步：
+受 [Superpowers](https://github.com/obra/superpowers) 和 [Harness Engineering](https://martinfowler.com/articles/harness-engineering.html) 启发，内置 8 阶段门禁管道：
 
 ```
-brainstorming → writing-plans → subagent-driven-development → finishing-a-development-branch
-                                        ↑                              ↑
-                              systematic-debugging            verification-before-completion
-                              （遇 Bug 时触发）              （任何完成声明前触发）
-                                                    ↑
-                                          entropy-management
-                                          （定期维护触发）
+需求收集 → 需求验证 → 方案设计 → 任务拆解 → 实施开发 → 测试验证 → 文档更新 → 分支收尾
 ```
 
 | 技能 | 触发时机 | 核心规则 |
 |------|---------|---------|
-| **brainstorming** | 任何创造性工作之前 | 一次一个问题、2-3 方案对比、用户批准后才能继续 |
-| **writing-plans** | 有设计方案后、编码前 | 任务粒度 2-5 分钟、禁止占位符、每步有完整代码 |
-| **subagent-driven-development** | 有计划后、开发执行 | 每任务新子代理、两阶段审查（先规格后质量） |
-| **systematic-debugging** | 遇到 Bug/测试失败 | 四阶段根因分析、3 次失败后质疑架构 |
-| **verification-before-completion** | 声称完成/通过之前 | 无验证证据不得声明完成 |
-| **finishing-a-development-branch** | 所有任务完成后 | 全量测试 → 四选一集成方式 → 清理 |
-| **entropy-management** | 定期维护/漂移信号 | 传感器扫描 → 推理检查 → 修复 → 更新质量评分 |
+| **brainstorming** | 创造性工作之前 | 一次一个问题、2-3 方案对比、用户批准后继续 |
+| **writing-plans** | 编码前 | 任务粒度 2-5 分钟、禁止占位符、每步有完整代码 |
+| **subagent-driven-development** | 开发执行 | 每任务新子代理、两阶段审查 |
+| **systematic-debugging** | Bug/测试失败 | 四阶段根因分析、3 次失败后质疑架构 |
+| **verification-before-completion** | 声称完成前 | 无验证证据不得声明完成 |
+| **finishing-a-development-branch** | 任务完成后 | 全量测试 → 集成 → 清理 |
+| **entropy-management** | 定期维护 | 传感器扫描 → 修复 → 更新质量评分 |
 
 ### 两阶段审查
 
-每次 Jarvis 完成开发后，Kyle 按严格顺序执行：
-
 1. **Stage 1：规格符合性** — 多了什么？少了什么？偏离了什么？
 2. **Stage 2：代码质量** — 干净、安全、可维护？
 
-Stage 1 不通过 → 修复 → 重审 Stage 1 → 通过后才进入 Stage 2
+Stage 1 不通过 → 修复 → 重审 → 通过后才进入 Stage 2。
 
 ### 三条铁律
 
@@ -284,72 +230,60 @@ Stage 1 不通过 → 修复 → 重审 Stage 1 → 通过后才进入 Stage 2
 3. 不确定时先问 — 宁可多问一句，不要假设
 ```
 
-## 使用示例
-
-### 示例 1：完整功能开发
-
-```
-你: 帮我做一个用户认证系统
-
-Max: [启动 brainstorming] → 逐个提问澄清需求 → 展示设计方案 → 用户批准
-Max: [启动 writing-plans] → 产出分步实现计划 → 用户确认
-Max: [启动 subagent-driven-development]
-  → 派遣 Jarvis 执行任务 1 → Kyle Stage 1 审查 → Kyle Stage 2 审查
-  → 派遣 Jarvis 执行任务 2 → Kyle Stage 1 审查 → Kyle Stage 2 审查
-  → ...
-Max: [启动 finishing-a-development-branch] → 全量测试 → 用户选择集成方式
-```
-
-### 示例 2：直接派遣设计
+## 技能体系
 
-```
-/ella 设计一个电商首页，风格参考 Apple Store，需要有 hero banner、商品分类、推荐列表
+### 技能与角色对应
 
-→ Ella 读取 PERSONA 和 ui-ux-pro-max 技能
-→ 产出设计稿到 .dev-agents/shared/designs/ecommerce-home.md
-→ 返回：设计稿路径 + 设计决策摘要 + 实现注意事项
-```
+```mermaid
+flowchart TB
+    subgraph MAX["Max 项目经理"]
+        M1["workflow\n8阶段工作流管道"]
+        M2["PM 辅助技能\n竞品分析/PRD/会议纪要等"]
+    end
 
-### 示例 3：代码审查
+    subgraph ELLA["Ella 设计师"]
+        E1["ui-ux-pro-max\n50+ 设计风格"]
+        E2["senior-frontend\n前端最佳实践"]
+        E3["前端框架 x7\nReact/Vue/Angular/Next.js\nFlutter/RN"]
+    end
 
-```
-/kyle 审查 src/auth/ 目录下的认证模块代码，对照实现计划 .dev-agents/shared/tasks/auth-plan.md
+    subgraph JARVIS["Jarvis 开发"]
+        J1["架构与设计 x7"]
+        J2["后端框架 x7"]
+        J3["编程语言 x11"]
+        J4["数据库与数据 x8"]
+        J5["DevOps x6"]
+        J6["安全与工具 x6"]
+    end
 
-→ Kyle 读取实现计划和代码
-→ Stage 1：逐条检查规格符合性
-→ Stage 2：检查代码质量、安全性、可维护性
-→ 产出审查报告到 .dev-agents/shared/reviews/auth-review.md
+    subgraph KYLE["Kyle 质量保障"]
+        K1["senior-qa + tdd-guide"]
+        K2["test-master + code-reviewer"]
+        K3["security-reviewer"]
+        K4["playwright-expert + chaos-engineer"]
+    end
 ```
 
-### 示例 4：Bug 调试
-
-```
-你: 用户登录后 token 刷新失败，返回 401
-
-→ Max 检测到 Bug 信号，启动 systematic-debugging
-→ 派遣 Jarvis 执行四阶段根因调查
-→ 第一阶段：阅读错误信息、稳定复现
-→ 第二阶段：找到可工作示例，对照差异
-→ 第三阶段：假设验证（一次一个变量）
-→ 第四阶段：创建失败测试 → 修复 → 验证
-```
+### 技能分布
 
-### 示例 5：Harness 健康检查
+| 角色 | 技能数 | 核心领域 |
+|------|--------|---------|
+| **Max** (PM) | 16 | 8 阶段工作流管道 + 3 横切技能 + 5 PM 辅助技能 |
+| **Ella** (设计) | 10 | UI/UX 设计 + 前端最佳实践 + 7 前端框架 |
+| **Jarvis** (开发) | 45 | 架构设计、后端框架、编程语言、数据库、DevOps、安全编码 |
+| **Kyle** (QA) | 7 | QA 实践、TDD、测试策略、代码审查、安全审计、E2E、混沌工程 |
 
-```
-你: 跑一下项目健康检查
+### 技能来源
 
-→ Max 启动 entropy-management 技能
-→ 第一阶段：运行 scripts/harness/run-all.sh 自动化扫描
-→ 第二阶段：推理型扫描（文档一致性、架构漂移）
-→ 第三阶段：修复问题 + 将重复问题编码为约束
-→ 第四阶段：更新 docs/QUALITY_SCORE.md 和 docs/tech-debt-tracker.md
-```
+| 技能 | 来源 | 许可证 |
+|------|------|--------|
+| 工作流技能 (11个) | 原创，受 [obra/superpowers](https://github.com/obra/superpowers) 和 [Harness Engineering](https://martinfowler.com/articles/harness-engineering.html) 启发 | MIT |
+| 开发/QA/前端技能 (62个) | [Jeffallan/claude-skills](https://github.com/Jeffallan/claude-skills) | MIT |
+| PM 辅助技能 (5个) | [mohitagw15856/pm-claude-skills](https://github.com/mohitagw15856/pm-claude-skills) | MIT |
+| UI/UX Pro Max / Senior 系列 | SkillsMP 技能市场 | MIT |
 
 ## 集成到已有项目
 
-aiGroup 可以作为"脚手架"集成到你的任何项目中。
-
 ### 方式一：CLI 工具（推荐）
 
 ```bash
@@ -361,272 +295,104 @@ npx aigroup-workflow init
 
 ### 方式二：手动复制
 
-将以下目录和文件复制到你的项目根目录：
-
 ```bash
 # 必须复制
 CLAUDE.md                    # Agent 入口
 docs/                        # 知识库
-.claude/                     # Claude Code 配置（commands/ + hooks.json + settings.json）
+.claude/                     # Claude Code 配置
 .dev-agents/                 # 角色定义 + 协作产物目录
 scripts/harness/             # Harness 传感器
 
 # 按需复制
 skills/max/workflow/         # 工作流技能（强烈推荐）
-skills/ella/                 # 设计技能（如果需要 UI 设计）
-skills/jarvis/               # 开发技能（如果需要工程技能集）
-skills/kyle/                 # QA 技能（如果需要质量保障）
+skills/ella/                 # 设计技能
+skills/jarvis/               # 开发技能
+skills/kyle/                 # QA 技能
 ```
 
-### 适配你的项目
-
-1. **编辑 `CLAUDE.md`**：不需要大改，只需确认知识库地图路径正确
-2. **编辑 `docs/ARCHITECTURE.md`**：替换为你项目的架构描述
-3. **编辑 `docs/coding-standards.md`**：替换为你项目的编码规范
-4. **编辑 `.dev-agents/*/PERSONA.md`**：根据需要调整角色定义
-
 ### 验证安装
 
 ```bash
-aigroup check
+aig check
 # 或
 bash scripts/harness/run-all.sh
 ```
 
-所有检查通过即可开始使用。
-
-## 常用命令速查
-
-### 日常使用
-
-| 命令 | 说明 | 使用场景 |
-|------|------|---------|
-| `claude` | 启动 Claude Code + Max | 开始工作 |
-| `/ella <任务>` | 直接派遣设计师 | 界面设计、交互原型 |
-| `/jarvis <任务>` | 直接派遣开发 | 编码、技术方案、Bug 修复 |
-| `/kyle <任务>` | 直接派遣质量保障 | 代码审查、功能验收 |
-
-### CLI 工具
-
-| 命令 | 说明 |
-|------|------|
-| `aigroup init` | 交互式初始化框架 |
-| `aigroup init --yes` | 使用默认配置初始化 |
-| `aigroup update` | 增量更新技能和传感器 |
-| `aigroup check` | 运行 Harness 健康检查 |
-| `aigroup status` | 查看工作流状态 |
-
-### Harness 维护
-
-| 命令 | 说明 | 建议频率 |
-|------|------|---------|
-| `bash scripts/harness/run-all.sh` | 全量 Harness 传感器检查 | 每次开发完成后 |
-| `bash scripts/check-gitignore.sh` | 检查 .gitignore 规则 | 添加新文件类型时 |
-| `bash scripts/clean-system-files.sh` | 清理 .DS_Store 等系统文件 | 偶尔运行 |
-
-> Windows 用户：用 Git Bash 运行以上命令（`"D:\Git\bin\bash.exe" scripts/harness/run-all.sh`）。
-
-### 自定义与扩展
-
-| 想要做 | 修改什么 |
-|--------|---------|
-| 调整 Agent 角色定义 | `.dev-agents/{name}/PERSONA.md` |
-| 修改工作流规则 | `skills/max/workflow/{skill}/SKILL.md` |
-| 添加新的编码规范 | `docs/coding-standards.md` |
-| 添加新的传感器检查 | `scripts/harness/lint-*.sh` 中添加检查项 |
-| 添加新的危险信号 | `docs/red-flags.md` 中添加条目 |
-| 将重复问题编码为约束 | 遵循 `docs/steering-loop.md` 转向循环流程 |
-| 添加新的 Hook | `.claude/hooks.json` 中添加事件 |
-| 修改权限控制 | `.claude/settings.json` 中调整 allow/deny |
-| 添加新团队成员 | 新建 `.dev-agents/{name}/PERSONA.md` + `.claude/commands/{name}.md` |
-
 ## 项目结构
 
 ```
 aiGroup/
-├── CLAUDE.md                  # Agent 入口：全局地图
+├── CLAUDE.md                  # Agent 入口
 ├── package.json               # npm 包配置
 ├── bin/aigroup.mjs            # CLI 入口
 ├── cli/                       # CLI 实现
-│   ├── commands/              #   init / update / check / status
+│   ├── commands/              #   init / update / check / status / menu
 │   └── utils/                 #   prompts / logger / scaffold
 ├── docs/                      # 知识库（唯一事实源）
-│   ├── ARCHITECTURE.md        #   项目架构总览
-│   ├── workflow-pipeline.md   #   工作流管道详细规则
-│   ├── dispatch-rules.md      #   派遣规则与上下文传递
-│   ├── coding-standards.md    #   编码与 Git 规范
-│   ├── red-flags.md           #   危险信号检测
-│   ├── QUALITY_SCORE.md       #   质量评分追踪
-│   ├── tech-debt-tracker.md   #   技术债追踪
-│   └── steering-loop.md       #   Harness 转向循环
-├── .claude/                   # Claude Code 原生配置
-│   ├── settings.json          #   项目级权限设置
-│   ├── hooks.json             #   Harness 生命周期 Hooks
-│   └── commands/              #   斜杠命令（/ella /jarvis /kyle）
+├── .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/）
-├── skills/                    # 技能资源（按角色分组）
-│   ├── max/                   #   PM 技能
-│   │   ├── workflow/          #     8 阶段工作流管道 + 横切技能（11 个）
-│   │   ├── competitive-analysis/  # 竞品分析
-│   │   ├── meeting-notes/         # 会议纪要
-│   │   ├── prd-template/          # PRD 撰写
-│   │   ├── stakeholder-update/    # 干系人汇报
-│   │   └── user-research-synthesis/ # 用户研究综合
-│   ├── ella/                  #   设计技能（10 个）
-│   │   ├── ui-ux-pro-max/     #     50+ 设计风格、97 色彩方案
-│   │   ├── senior-frontend/   #     前端最佳实践
-│   │   ├── react-expert/      #     React 组件与 Hooks
-│   │   ├── nextjs-developer/  #     Next.js SSR/SSG
-│   │   ├── vue-expert/        #     Vue 3 (TypeScript)
-│   │   ├── vue-expert-js/     #     Vue 3 (JavaScript)
-│   │   ├── angular-architect/ #     Angular 企业级架构
-│   │   ├── react-native-expert/ #   React Native 移动端
-│   │   ├── flutter-expert/    #     Flutter 跨平台
-│   │   └── commands/          #     设计工具命令
-│   ├── jarvis/                #   开发技能（45 个）
-│   │   ├── architecture-designer/  # 系统架构设计
-│   │   ├── api-designer/           # API 设计
-│   │   ├── fullstack-guardian/     # 全栈安全开发
-│   │   ├── microservices-architect/ # 微服务架构
-│   │   ├── secure-code-guardian/   # 安全编码
-│   │   ├── debugging-wizard/       # 系统化调试
-│   │   ├── typescript-pro/         # TypeScript 专家
-│   │   ├── python-pro/             # Python 专家
-│   │   ├── golang-pro/             # Go 专家
-│   │   └── ...                     # 更多语言/框架/DevOps 技能
-│   └── kyle/                  #   QA 技能（7 个）
-│       ├── senior-qa/         #     QA 最佳实践
-│       ├── tdd-guide/         #     TDD 指南
-│       ├── test-master/       #     测试策略
-│       ├── code-reviewer/     #     代码审查
-│       ├── security-reviewer/ #     安全审计
-│       ├── playwright-expert/ #     E2E 测试
-│       └── chaos-engineer/    #     混沌工程
-├── scripts/                   # 自动化脚本
-│   ├── harness/               #   Harness 传感器套件
-│   │   ├── run-all.sh         #     全量传感器运行器
-│   │   ├── lint-structure.sh  #     结构检查
-│   │   ├── lint-docs.sh       #     文档新鲜度检查
-│   │   ├── lint-workflow-artifacts.sh  # 工作流产物检查
-│   │   ├── hook-post-edit.sh  #     PostToolUse Hook
-│   │   ├── hook-stop.sh       #     Stop Hook（back-pressure）
-│   │   └── hook-subagent-stop.sh  #  SubagentStop Hook
-│   ├── check-gitignore.sh     #   .gitignore 规则检查
-│   └── clean-system-files.sh  #   系统文件清理
-└── README.md
-```
-
-## 技能体系
-
-### 技能与角色对应
-
-```mermaid
-flowchart TB
-    subgraph MAX["Max 项目经理"]
-        M1["workflow\n8阶段工作流管道"]
-        M2["PM 辅助技能\n竞品分析/PRD/会议纪要等"]
-    end
-
-    subgraph ELLA["Ella 设计师"]
-        E1["ui-ux-pro-max\n50+ 设计风格"]
-        E2["senior-frontend\n前端最佳实践"]
-        E3["前端框架 x7\nReact/Vue/Angular/Next.js\nFlutter/RN"]
-    end
-
-    subgraph JARVIS["Jarvis 开发"]
-        J1["架构与设计 x7"]
-        J2["后端框架 x7"]
-        J3["编程语言 x11"]
-        J4["数据库与数据 x8"]
-        J5["DevOps x6"]
-        J6["安全与工具 x6"]
-    end
-
-    subgraph KYLE["Kyle 质量保障"]
-        K1["senior-qa + tdd-guide"]
-        K2["test-master\n测试策略"]
-        K3["code-reviewer\n代码审查"]
-        K4["security-reviewer\n安全审计"]
-        K5["playwright-expert\nE2E 测试"]
-        K6["chaos-engineer\n混沌工程"]
-    end
+│   └── 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 传感器套件
 ```
 
-### 技能分布总览
-
-| 角色 | 技能数 | 核心领域 |
-|------|--------|---------|
-| **Max** (PM) | 16 | 8 阶段工作流管道 + 3 横切技能 + 5 PM 辅助技能 |
-| **Ella** (设计) | 10 | UI/UX 设计 + 前端最佳实践 + 7 前端框架 |
-| **Jarvis** (开发) | 45 | 架构设计、后端框架、编程语言、数据库、DevOps、安全编码 |
-| **Kyle** (QA) | 7 | QA 实践、TDD、测试策略、代码审查、安全审计、E2E、混沌工程 |
-
-## 技能来源
-
-| 技能 | 来源 | 许可证 |
-|------|------|--------|
-| 工作流技能 (11个) | 原创，受 [obra/superpowers](https://github.com/obra/superpowers) 和 [Harness Engineering](https://martinfowler.com/articles/harness-engineering.html) 启发 | MIT |
-| Jarvis/Kyle/Ella 开发技能 (62个) | [Jeffallan/claude-skills](https://github.com/Jeffallan/claude-skills) | MIT |
-| PM 辅助技能 (5个) | [mohitagw15856/pm-claude-skills](https://github.com/mohitagw15856/pm-claude-skills) | MIT |
-| UI/UX Pro Max | SkillsMP 技能市场 | MIT |
-| Senior Frontend / QA / TDD | SkillsMP 技能市场 | MIT |
-
-## Harness Engineering 体系
-
-aiGroup 采用 [Harness Engineering](https://martinfowler.com/articles/harness-engineering.html) 理念，通过约束、反馈回路和持续改进循环提升 Agent 可靠性。
-
-### 核心公式
+## Harness Engineering
 
 ```
 Agent = Model + Harness
 ```
 
-不优化模型本身，而是优化模型运行的环境。
-
-### 四层防线
-
 | 层级 | 机制 | 实现 |
 |------|------|------|
-| **前馈引导** | 在 Agent 行动前引导方向 | CLAUDE.md 地图、Skills 渐进披露、工作流管道 |
-| **计算型反馈** | 确定性检查，快速自动运行 | `scripts/harness/` 传感器套件 + Claude Code Hooks |
-| **推理型反馈** | AI 语义审查 | Kyle 两阶段审查（规格符合性 + 代码质量） |
-| **熵管理** | 防止长期退化 | entropy-management 技能 + 质量评分追踪 |
-
-### Harness 传感器
+| **前馈引导** | 行动前引导 | CLAUDE.md、Skills、工作流管道 |
+| **计算型反馈** | 确定性检查 | Harness 传感器 + Hooks |
+| **推理型反馈** | AI 审查 | Kyle 两阶段审查 |
+| **熵管理** | 防退化 | entropy-management + 质量评分 |
 
 ```bash
 bash scripts/harness/run-all.sh   # 全量检查
 ```
 
-传感器输出对 Agent 友好：`[PASS]` 通过、`[FAIL]` 失败 + `[FIX]` 修复指令。
-
-### 转向循环
-
-```
-发现重复问题 → 编码为约束（Linter/文档/技能）→ 自动执行 → 更新质量评分
-```
-
-详见 `docs/steering-loop.md`。
-
-### 知识库
+## 常用命令速查
 
-所有规范、架构决策、质量追踪均版本化存储在 `docs/` 目录下，作为项目的唯一事实源。
-CLAUDE.md 仅作为地图入口（< 100 行），详细内容按需从 `docs/` 检索。
+| 命令 | 说明 |
+|------|------|
+| `aig` | 交互式主菜单 |
+| `aig init` | 初始化框架 |
+| `aig update` | 增量更新 |
+| `aig check` | 健康检查 |
+| `aig status` | 工作流状态 |
+| `/ella <任务>` | 派遣设计师 |
+| `/jarvis <任务>` | 派遣开发 |
+| `/kyle <任务>` | 派遣 QA |
+| `/init-project <名称>` | 项目 AI 上下文初始化 |
+| `/git-commit` | 智能 Git 提交 |
+
+> `aig` 是 `aigroup` 的短别名。npx 用户：`npx aigroup-workflow <命令>`。
 
 ## 致谢
 
-本项目基于 [yezannnnn/agentGroup](https://github.com/yezannnnn/agentGroup) 进行开发和扩展。感谢原作者 [@yezannnnn](https://github.com/yezannnnn) 提出的四 AI 专业分工协作框架理念，为本项目奠定了坚实的基础。
+本项目基于 [yezannnnn/agentGroup](https://github.com/yezannnnn/agentGroup) 进行开发和扩展。感谢原作者 [@yezannnnn](https://github.com/yezannnnn) 提出的四 AI 专业分工协作框架理念。
 
 ## 社区支持
 
 <div align="center">
 
-**学 AI，上 L 站**
-
 [![LINUX DO](https://img.shields.io/badge/LINUX%20DO-社区-gray?style=flat-square)](https://linux.do/) [![社区支持](https://img.shields.io/badge/社区支持-交流-blue?style=flat-square)](https://linux.do/)
 
 本项目在 [LINUX DO](https://linux.do/) 社区发布与交流，感谢佬友们的支持与反馈。

package/bin/aigroup.mjs

@@ -67,11 +67,15 @@ async function main() {
     }
     case 'help':
     case '--help':
-    case '-h':
-    case '': {
+    case '-h': {
       printHelp()
       break
     }
+    case '': {
+      const { showMenu } = await import('../cli/commands/menu.mjs')
+      await showMenu(ctx)
+      break
+    }
     default: {
       console.error(`\n  未知命令: ${command}\n`)
       printHelp()
@@ -86,7 +90,7 @@ function printHelp() {
   ║   aiGroup — AI 团队协作框架 CLI          ║
   ╚══════════════════════════════════════════╝
 
-  用法: aigroup <命令> [选项]
+  用法: aig <命令> [选项]        （也可用 aigroup）
 
   命令:
     init,   i     完整初始化（交互式选择角色、技能、配置）
@@ -97,13 +101,12 @@ function printHelp() {
 
   选项:
     --yes, -y     跳过确认，全部使用默认值
-    --lang <语言>  设置语言（zh-CN / en）
 
   示例:
-    npx aigroup-workflow init          # 交互式初始化
-    npx aigroup-workflow init --yes    # 使用默认配置初始化
-    npx aigroup-workflow update        # 增量更新
-    npx aigroup-workflow check         # 健康检查
+    npx aig init              # 交互式初始化
+    npx aig init --yes        # 使用默认配置初始化
+    npx aig update            # 增量更新
+    npx aig check             # 健康检查
 `)
 }
 

package/cli/commands/init.mjs

@@ -43,9 +43,9 @@ export async function init(ctx) {
     log.info('使用默认配置：全部角色')
   } else {
     selectedAgents = await multiSelect('选择要安装的团队成员', [
-      { name: AGENT_ASSETS.jarvis.label, value: 'jarvis', checked: true },
-      { name: AGENT_ASSETS.ella.label, value: 'ella', checked: true },
-      { name: AGENT_ASSETS.kyle.label, value: 'kyle', checked: true },
+      { name: '贾维斯 (Jarvis)', value: 'jarvis', description: '全栈开发工程师 · 45 Skills', checked: true },
+      { name: '艾拉 (Ella)', value: 'ella', description: 'UI/UX 设计师 · 10 Skills', checked: true },
+      { name: '凯尔 (Kyle)', value: 'kyle', description: '质量保证工程师 · 7 Skills', checked: true },
     ])
 
     if (selectedAgents.length === 0) {

package/cli/commands/menu.mjs

@@ -0,0 +1,65 @@
+/**
+ * menu 命令 — 交互式主菜单（类似 zcf 风格）
+ */
+
+import { select } from '../utils/prompts.mjs'
+import * as log from '../utils/logger.mjs'
+import { isInitialized, readConfig } from '../utils/scaffold.mjs'
+
+export async function showMenu(ctx) {
+  log.banner()
+
+  // 检测项目状态
+  const initialized = isInitialized(ctx.PROJECT_ROOT)
+  if (initialized) {
+    const config = readConfig(ctx.PROJECT_ROOT)
+    if (config) {
+      log.dim(`已初始化 · 角色: ${config.agents?.join(', ') || '未知'} · 版本: ${config.version || '?'}`)
+    }
+  } else {
+    log.dim('当前项目尚未初始化 aiGroup 框架')
+  }
+
+  // 主菜单循环
+  while (true) {
+    const action = await select('选择操作', [
+      { name: '初始化项目', value: 'init', description: '交互式选择角色和技能，安装框架文件' },
+      { name: '增量更新', value: 'update', description: '更新技能和传感器，保留自定义配置' },
+      { name: '健康检查', value: 'check', description: '运行 Harness 传感器全量检查' },
+      { name: '工作流状态', value: 'status', description: '查看当前工作流管道状态' },
+      { name: '退出', value: 'quit', description: '' },
+    ])
+
+    if (action === 'quit') {
+      console.log('')
+      break
+    }
+
+    console.log('')
+
+    switch (action) {
+      case 'init': {
+        const { init } = await import('./init.mjs')
+        await init(ctx)
+        break
+      }
+      case 'update': {
+        const { update } = await import('./update.mjs')
+        await update(ctx)
+        break
+      }
+      case 'check': {
+        const { check } = await import('./check.mjs')
+        await check(ctx)
+        break
+      }
+      case 'status': {
+        const { status } = await import('./status.mjs')
+        await status(ctx)
+        break
+      }
+    }
+
+    console.log('')
+  }
+}

package/cli/utils/prompts.mjs

@@ -1,9 +1,30 @@
 /**
- * 交互式提示工具 — 零依赖，基于 Node.js readline
+ * 交互式提示工具 — 零依赖，inquirer 风格
+ *
+ * 样式参考 zcf (https://github.com/UfoMiao/zcf)
+ * - 方向键移动光标
+ * - 空格切换选中（多选）/ 回车选择（单选）
+ * - 彩色描述文字
  */
 
 import { createInterface } from 'node:readline'
 
+// ── ANSI 颜色 ──
+
+const C = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  cyan: '\x1b[36m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  gray: '\x1b[90m',
+  blue: '\x1b[34m',
+  white: '\x1b[37m',
+  hideCursor: '\x1b[?25l',
+  showCursor: '\x1b[?25h',
+}
+
 function createRL() {
   return createInterface({
     input: process.stdin,
@@ -18,7 +39,7 @@ export async function confirm(message, defaultValue = true) {
   const rl = createRL()
   const hint = defaultValue ? 'Y/n' : 'y/N'
   return new Promise(resolve => {
-    rl.question(`  ? ${message} (${hint}) `, answer => {
+    rl.question(`  ${C.cyan}?${C.reset} ${C.bold}${message}${C.reset} ${C.dim}(${hint})${C.reset} `, answer => {
       rl.close()
       if (!answer.trim()) return resolve(defaultValue)
       resolve(answer.trim().toLowerCase().startsWith('y'))
@@ -31,9 +52,9 @@ export async function confirm(message, defaultValue = true) {
  */
 export async function input(message, defaultValue = '') {
   const rl = createRL()
-  const hint = defaultValue ? ` (${defaultValue})` : ''
+  const hint = defaultValue ? ` ${C.dim}(${defaultValue})${C.reset}` : ''
   return new Promise(resolve => {
-    rl.question(`  ? ${message}${hint}: `, answer => {
+    rl.question(`  ${C.cyan}?${C.reset} ${C.bold}${message}${C.reset}${hint} `, answer => {
       rl.close()
       resolve(answer.trim() || defaultValue)
     })
@@ -41,9 +62,10 @@ export async function input(message, defaultValue = '') {
 }
 
 /**
- * 多选菜单 — 方向键移动，空格切换选中，回车确认
+ * 多选菜单 — inquirer checkbox 风格
+ *
  * @param {string} message
- * @param {{ name: string, value: string, checked?: boolean }[]} choices
+ * @param {{ name: string, value: string, description?: string, checked?: boolean }[]} choices
  * @returns {Promise<string[]>}
  */
 export async function multiSelect(message, choices) {
@@ -52,26 +74,35 @@ export async function multiSelect(message, choices) {
   )
   let cursor = 0
 
-  function render() {
-    // 移动光标到列表起始位置并清除下方内容
-    process.stdout.write(`\x1B[${choices.length + 1}A`)
-    process.stdout.write('\x1B[0J')
-    choices.forEach((c, i) => {
-      const pointer = i === cursor ? '❯' : ' '
-      const mark = selected.has(c.value) ? '◉' : '◯'
-      console.log(`    ${pointer} ${mark} ${c.name}`)
-    })
-    process.stdout.write('  ↑↓ 移动  空格 切换  回车 确认')
+  function renderLine(c, i) {
+    const pointer = i === cursor ? `${C.cyan}❯${C.reset}` : ' '
+    const check = selected.has(c.value)
+      ? `${C.green}◉${C.reset}`
+      : `${C.dim}◯${C.reset}`
+    const name = i === cursor ? `${C.white}${C.bold}${c.name}${C.reset}` : c.name
+    const desc = c.description ? ` ${C.gray}— ${c.description}${C.reset}` : ''
+    return `  ${pointer} ${check} ${name}${desc}`
+  }
+
+  function renderHint() {
+    return `  ${C.dim}↑↓ 移动${C.reset}  ${C.dim}空格 选择${C.reset}  ${C.dim}a 全选/取消${C.reset}  ${C.dim}回车 确认${C.reset}`
+  }
+
+  function render(isFirst) {
+    if (!isFirst) {
+      // 回到列表顶部重绘
+      process.stdout.write(`\x1b[${choices.length + 1}A\x1b[0J`)
+    }
+    for (const [i, c] of choices.entries()) {
+      console.log(renderLine(c, i))
+    }
+    process.stdout.write(renderHint())
   }
 
   // 首次绘制
-  console.log(`\n  ? ${message}`)
-  choices.forEach((c, i) => {
-    const pointer = i === cursor ? '❯' : ' '
-    const mark = selected.has(c.value) ? '◉' : '◯'
-    console.log(`    ${pointer} ${mark} ${c.name}`)
-  })
-  process.stdout.write('  ↑↓ 移动  空格 切换  回车 确认')
+  console.log(`\n  ${C.cyan}?${C.reset} ${C.bold}${message}${C.reset} ${C.dim}(空格选择, 回车确认)${C.reset}`)
+  process.stdout.write(C.hideCursor)
+  render(true)
 
   return new Promise(resolve => {
     const { stdin } = process
@@ -84,29 +115,43 @@ export async function multiSelect(message, choices) {
       // Ctrl+C
       if (key === '\x03') {
         cleanup()
+        process.stdout.write(C.showCursor)
         process.exit(0)
       }
       // 回车 — 确认
       if (key === '\r' || key === '\n') {
         cleanup()
-        // 清除提示行并显示最终选择
-        process.stdout.write('\r\x1B[K\n')
-        return resolve([...selected])
+        process.stdout.write(`\r\x1b[K\n`)
+        process.stdout.write(C.showCursor)
+        // 打印选择结果
+        const result = [...selected]
+        const names = choices.filter(c => result.includes(c.value)).map(c => c.name)
+        if (names.length) {
+          console.log(`  ${C.green}✔${C.reset} 已选择: ${C.cyan}${names.join(', ')}${C.reset}`)
+        }
+        return resolve(result)
       }
       // 空格 — 切换选中
       if (key === ' ') {
         const val = choices[cursor].value
         if (selected.has(val)) selected.delete(val)
         else selected.add(val)
-        render()
+        render(false)
         return
       }
-      // 方向键（上: \x1B[A, 下: \x1B[B）
-      if (key === '\x1B[A' || key === '\x1B[B') {
-        if (key === '\x1B[A') cursor = (cursor - 1 + choices.length) % choices.length
-        else cursor = (cursor + 1) % choices.length
-        render()
+      // a — 全选/全不选
+      if (key === 'a' || key === 'A') {
+        if (selected.size === choices.length) {
+          selected.clear()
+        } else {
+          for (const c of choices) selected.add(c.value)
+        }
+        render(false)
+        return
       }
+      // 方向键
+      if (key === '\x1b[A') { cursor = (cursor - 1 + choices.length) % choices.length; render(false) }
+      if (key === '\x1b[B') { cursor = (cursor + 1) % choices.length; render(false) }
     }
 
     function cleanup() {
@@ -120,29 +165,71 @@ export async function multiSelect(message, choices) {
 }
 
 /**
- * 单选菜单
+ * 单选菜单 — inquirer list 风格
+ *
  * @param {string} message
- * @param {{ name: string, value: string }[]} choices
+ * @param {{ name: string, value: string, description?: string }[]} choices
  * @returns {Promise<string>}
  */
 export async function select(message, choices) {
-  console.log(`\n  ? ${message}`)
-  console.log('')
+  let cursor = 0
 
-  choices.forEach((c, i) => {
-    console.log(`    ${i + 1}. ${c.name}`)
-  })
+  function renderLine(c, i) {
+    const pointer = i === cursor ? `${C.cyan}❯${C.reset}` : ' '
+    const name = i === cursor ? `${C.cyan}${C.bold}${c.name}${C.reset}` : c.name
+    const desc = c.description ? ` ${C.gray}— ${c.description}${C.reset}` : ''
+    return `  ${pointer} ${name}${desc}`
+  }
+
+  function renderHint() {
+    return `  ${C.dim}↑↓ 移动${C.reset}  ${C.dim}回车 选择${C.reset}`
+  }
+
+  function render(isFirst) {
+    if (!isFirst) {
+      process.stdout.write(`\x1b[${choices.length + 1}A\x1b[0J`)
+    }
+    for (const [i, c] of choices.entries()) {
+      console.log(renderLine(c, i))
+    }
+    process.stdout.write(renderHint())
+  }
+
+  // 首次绘制
+  console.log(`\n  ${C.cyan}?${C.reset} ${C.bold}${message}${C.reset}`)
+  process.stdout.write(C.hideCursor)
+  render(true)
 
-  const rl = createRL()
   return new Promise(resolve => {
-    rl.question(`\n  输入编号选择 (1-${choices.length}): `, answer => {
-      rl.close()
-      const idx = parseInt(answer.trim()) - 1
-      if (idx >= 0 && idx < choices.length) {
-        resolve(choices[idx].value)
-      } else {
-        resolve(choices[0].value)
+    const { stdin } = process
+    const wasRaw = stdin.isRaw
+    stdin.setRawMode(true)
+    stdin.resume()
+    stdin.setEncoding('utf-8')
+
+    function onData(key) {
+      if (key === '\x03') {
+        cleanup()
+        process.stdout.write(C.showCursor)
+        process.exit(0)
       }
-    })
+      if (key === '\r' || key === '\n') {
+        cleanup()
+        process.stdout.write(`\r\x1b[K\n`)
+        process.stdout.write(C.showCursor)
+        console.log(`  ${C.green}✔${C.reset} 已选择: ${C.cyan}${choices[cursor].name}${C.reset}`)
+        return resolve(choices[cursor].value)
+      }
+      if (key === '\x1b[A') { cursor = (cursor - 1 + choices.length) % choices.length; render(false) }
+      if (key === '\x1b[B') { cursor = (cursor + 1) % choices.length; render(false) }
+    }
+
+    function cleanup() {
+      stdin.removeListener('data', onData)
+      stdin.setRawMode(wasRaw ?? false)
+      stdin.pause()
+    }
+
+    stdin.on('data', onData)
   })
 }

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "aigroup-workflow",
-  "version": "1.1.1",
+  "version": "1.1.2",
   "description": "AI 团队协作框架 — 通过角色派遣、工作流管道和 Harness 传感器驱动 AI 协作开发",
   "type": "module",
   "bin": {
-    "aigroup": "bin/aigroup.mjs"
+    "aigroup": "bin/aigroup.mjs",
+    "aig": "bin/aigroup.mjs"
   },
   "files": [
     "bin/",
@@ -29,7 +30,5 @@
   "engines": {
     "node": ">=18.0.0"
   },
-  "dependencies": {
-    "aigroup-workflow": "^1.0.0"
-  }
+  "dependencies": {}
 }