aigroup-workflow 1.2.2 → 1.2.3

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

@@ -1,5 +1,6 @@
 ---
 description: 初始化项目 AI 上下文，生成/更新根级与模块级 CLAUDE.md 索引
+allowed-tools: Read(**), Write(CLAUDE.md, **/CLAUDE.md)
 argument-hint: <项目摘要或名称>
 ---
 
@@ -13,71 +14,84 @@ argument-hint: <项目摘要或名称>
 
 - 在仓库根生成/更新 `CLAUDE.md`（高层愿景、架构总览、模块索引、全局规范）。
 - 在识别的各模块目录生成/更新本地 `CLAUDE.md`（接口、依赖、入口、测试、关键文件等）。
-- 为根 `CLAUDE.md` 自动生成 Mermaid 结构图，并为每个模块 `CLAUDE.md` 添加导航面包屑。
+- ✨ **为了提升可读性，会在根 `CLAUDE.md` 中自动生成 Mermaid 结构图，并为每个模块 `CLAUDE.md` 添加导航面包屑**。
 
-## 执行步骤
+## ⚠️ aiGroup 框架保护（铁律）
 
-### 步骤 1：全仓清点（轻量）
+根 `CLAUDE.md` 中存在 aiGroup 框架内容时，**必须保留**，不可覆盖或删除。
 
-快速统计文件与目录，识别模块根：
-- 查找 `package.json`、`pyproject.toml`、`go.mod`、`pom.xml`、`build.gradle` 等项目标识
-- 识别模块目录：`apps/*`、`packages/*`、`services/*`、`src/modules/*` 等
-- 统计文件数量和目录结构
-- 识别技术栈（语言、框架、构建工具）
+### 检测方法
 
-### 步骤 2：模块优先扫描（中等）
+在写入根 `CLAUDE.md` 前，先读取现有内容，检查是否包含以下特征标记（任一命中即为框架内容）：
 
-对每个模块做定点读取与样本抽取：
-- **入口文件**：`index.*`、`main.*`、`app.*`
-- **接口/API**：路由定义、控制器、GraphQL schema
-- **依赖**：`import`/`require` 语句分析，模块间引用关系
-- **测试**：测试文件和覆盖率配置
-- **数据模型**：实体定义、数据库 schema、类型声明
-- **质量工具**：ESLint、Prettier、TypeScript 配置
+- `## 角色：麦克斯 (Max)`
+- `## 全局铁律`
+- `## 行为门控`
+- `## 团队派遣`
+- `## Max 的职责边界`
 
-### 步骤 3：生成/更新 CLAUDE.md
+### 保护策略
 
-**根级 `CLAUDE.md`** 包含：
-- 项目愿景和简介（基于 $ARGUMENTS）
-- 技术栈总览
-- Mermaid 架构图
-- 模块索引（名称 + 路径 + 一句话职责）
-- 全局编码规范和约定
-- 常用命令速查
+**如果检测到框架内容**：
 
-**模块级 `<module>/CLAUDE.md`** 包含：
-- 导航面包屑（`← 返回根 CLAUDE.md`）
-- 模块职责描述
-- 关键文件和入口
-- 公开接口/API
-- 依赖关系（上游和下游）
-- 测试说明
+1. **完整保留**从文件开头到 `## Max 的职责边界` 章节结束的全部内容（即整个 aiGroup 框架区块）
+2. 在框架内容**末尾之后**追加分隔线和项目上下文：
 
-### 步骤 4：aiGroup 框架适配
+```markdown
+<!-- 以上为 aiGroup 框架配置，由 npx aigroup-workflow 安装，请勿修改 -->
 
-如果项目已安装 aiGroup 框架（存在 `.dev-agents/`）：
-- 更新 `docs/ARCHITECTURE.md` 为实际架构
-- 根据技术栈推荐 Jarvis 优先加载的技能
-- 运行 `bash scripts/harness/run-all.sh` 健康检查
+---
+
+# 项目上下文（由 /init-project 生成）
+
+[项目愿景、技术栈、Mermaid 架构图、模块索引、编码规范等]
+```
+
+3. 如果已有 `# 项目上下文` 区块，只更新该区块内容，不触碰框架区块
+
+**如果未检测到框架内容**（全新项目、未安装 aiGroup）：
+
+- 正常生成完整的 `CLAUDE.md`，无需保护
+
+### 模块级 CLAUDE.md
+
+模块级 `<module>/CLAUDE.md` 不受此保护限制，正常生成/更新。
+
+## 编排说明
+
+**步骤 1**：调用 `get-current-datetime` 子智能体获取当前时间戳。
+
+**步骤 2**：调用一次 `init-architect` 子智能体，输入：
+
+- `project_summary`: $ARGUMENTS
+- `current_timestamp`: (来自步骤1的时间戳)
+- `preserve_framework`: true/false（基于上述检测结果）
 
-## 覆盖率与增量更新
+## 执行策略（由 Agent 自适应决定，不需要用户传参）
 
-- 输出"已扫描文件数 / 估算总文件数"和"已覆盖模块占比"
-- 列出被忽略/跳过的原因和"建议下一步深挖的子路径"
-- 重复运行 `/init-project` 时做**增量更新**与**断点续扫**，不覆盖用户自定义内容
+- **阶段 A：全仓清点（轻量）**
+  快速统计文件与目录，识别模块根（package.json、pyproject.toml、go.mod、apps/_、packages/_、services/\* 等）。
+- **阶段 B：模块优先扫描（中等）**
+  对每个模块做"入口/接口/依赖/测试/数据模型/质量工具"的定点读取与样本抽取。
+- **阶段 C：深度补捞（按需）**
+  若仓库较小或模块规模较小，则扩大读取面；若较大，则对高风险/高价值路径分批追加扫描。
+- **覆盖率度量与可续跑**
+  输出"已扫描文件数 / 估算总文件数、已覆盖模块占比、被忽略/跳过原因"，并列出"建议下一步深挖的子路径"。重复运行 `/init-project` 时按上次索引做**增量更新**与**断点续扫**。
 
 ## 安全与边界
 
-- 只读/写文档与索引，**不改源代码**
-- 默认忽略 `node_modules`、`dist`、`build`、`.git`、二进制文件等生成物
-- 结果在主对话打印摘要，全文写入仓库
+- 只读/写文档与索引，不改源代码。
+- 默认忽略常见生成物与二进制大文件。
+- 结果在主对话打印"摘要"，全文写入仓库。
+- **绝不覆盖 aiGroup 框架内容**（角色定义、工作流管道、派遣规则等）。
 
 ## 输出要求
 
-在主对话中打印"初始化结果摘要"：
-1. 根级 `CLAUDE.md` 是否创建/更新、主要栏目概览
-2. 识别的模块数量及路径列表
-3. 每个模块 `CLAUDE.md` 的生成/更新情况
-4. 已生成 Mermaid 结构图和导航面包屑数量
-5. 覆盖率与主要缺口
-6. 若未读全：说明原因，并列出推荐的下一步
+- 在主对话中打印"初始化结果摘要"，包含：
+  - 根级 `CLAUDE.md` 是否创建/更新、主要栏目概览。
+  - ✨ **是否检测到 aiGroup 框架并已保护**（明确说明）。
+  - 识别的模块数量及其路径列表。
+  - 每个模块 `CLAUDE.md` 的生成/更新情况。
+  - ✨ **明确提及"已生成 Mermaid 结构图"和"已为 N 个模块添加导航面包屑"**。
+  - 覆盖率与主要缺口。
+  - 若未读全：说明"为何到此为止"，并列出**推荐的下一步**（例如"建议优先补扫：packages/auth/src/controllers"）。

package/package.json

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