aigroup-workflow 1.1.0 → 1.1.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.claude/commands/git-commit.md +61 -0
- package/.claude/commands/init-project.md +83 -0
- package/.claude/commands/jarvis.md +6 -3
- package/README.md +404 -621
- package/bin/aigroup.mjs +11 -8
- package/cli/commands/init.mjs +3 -3
- package/cli/commands/menu.mjs +65 -0
- package/cli/utils/prompts.mjs +135 -48
- package/package.json +4 -5
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
你是麦克斯 (Max)，项目经理。现在需要创建一个 Git 提交。
|
|
2
|
+
|
|
3
|
+
## 任务
|
|
4
|
+
|
|
5
|
+
$ARGUMENTS
|
|
6
|
+
|
|
7
|
+
## 执行步骤
|
|
8
|
+
|
|
9
|
+
### 1. 检查变更
|
|
10
|
+
|
|
11
|
+
```bash
|
|
12
|
+
git status
|
|
13
|
+
git diff --stat
|
|
14
|
+
```
|
|
15
|
+
|
|
16
|
+
### 2. 分析变更内容
|
|
17
|
+
|
|
18
|
+
查看所有变更的文件，理解改动的性质：
|
|
19
|
+
- 新功能 (feat)
|
|
20
|
+
- Bug 修复 (fix)
|
|
21
|
+
- 重构 (refactor)
|
|
22
|
+
- 文档 (docs)
|
|
23
|
+
- 配置/构建 (chore)
|
|
24
|
+
- 样式调整 (style)
|
|
25
|
+
- 测试 (test)
|
|
26
|
+
|
|
27
|
+
### 3. 生成提交信息
|
|
28
|
+
|
|
29
|
+
遵循 Conventional Commits 规范：
|
|
30
|
+
|
|
31
|
+
```
|
|
32
|
+
<type>(<scope>): <简短中文描述>
|
|
33
|
+
|
|
34
|
+
<详细说明（可选）>
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
**规则**：
|
|
38
|
+
- type 使用英文（feat/fix/refactor/docs/chore/style/test）
|
|
39
|
+
- scope 根据改动范围填写（模块名/文件名）
|
|
40
|
+
- 描述使用中文，简洁明确
|
|
41
|
+
- 不超过 72 字符
|
|
42
|
+
|
|
43
|
+
### 4. 执行提交
|
|
44
|
+
|
|
45
|
+
```bash
|
|
46
|
+
git add <相关文件>
|
|
47
|
+
git commit -m "<生成的提交信息>"
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
**注意**：
|
|
51
|
+
- 只添加相关变更文件，不要 `git add .`
|
|
52
|
+
- 不要添加 .env、credentials 等敏感文件
|
|
53
|
+
- 如果变更涉及多个不相关的功能，拆分为多次提交
|
|
54
|
+
- 提交前确认没有遗漏的文件
|
|
55
|
+
|
|
56
|
+
### 5. 输出
|
|
57
|
+
|
|
58
|
+
报告：
|
|
59
|
+
1. 提交的文件列表
|
|
60
|
+
2. 提交信息
|
|
61
|
+
3. 提交哈希
|
|
@@ -0,0 +1,83 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: 初始化项目 AI 上下文，生成/更新根级与模块级 CLAUDE.md 索引
|
|
3
|
+
argument-hint: <项目摘要或名称>
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
## 用法
|
|
7
|
+
|
|
8
|
+
`/init-project <项目摘要或名称>`
|
|
9
|
+
|
|
10
|
+
## 目标
|
|
11
|
+
|
|
12
|
+
以"根级简明 + 模块级详尽"的混合策略初始化项目 AI 上下文：
|
|
13
|
+
|
|
14
|
+
- 在仓库根生成/更新 `CLAUDE.md`（高层愿景、架构总览、模块索引、全局规范）。
|
|
15
|
+
- 在识别的各模块目录生成/更新本地 `CLAUDE.md`（接口、依赖、入口、测试、关键文件等）。
|
|
16
|
+
- 为根 `CLAUDE.md` 自动生成 Mermaid 结构图，并为每个模块 `CLAUDE.md` 添加导航面包屑。
|
|
17
|
+
|
|
18
|
+
## 执行步骤
|
|
19
|
+
|
|
20
|
+
### 步骤 1：全仓清点（轻量）
|
|
21
|
+
|
|
22
|
+
快速统计文件与目录，识别模块根：
|
|
23
|
+
- 查找 `package.json`、`pyproject.toml`、`go.mod`、`pom.xml`、`build.gradle` 等项目标识
|
|
24
|
+
- 识别模块目录：`apps/*`、`packages/*`、`services/*`、`src/modules/*` 等
|
|
25
|
+
- 统计文件数量和目录结构
|
|
26
|
+
- 识别技术栈（语言、框架、构建工具）
|
|
27
|
+
|
|
28
|
+
### 步骤 2：模块优先扫描（中等）
|
|
29
|
+
|
|
30
|
+
对每个模块做定点读取与样本抽取：
|
|
31
|
+
- **入口文件**：`index.*`、`main.*`、`app.*`
|
|
32
|
+
- **接口/API**：路由定义、控制器、GraphQL schema
|
|
33
|
+
- **依赖**：`import`/`require` 语句分析，模块间引用关系
|
|
34
|
+
- **测试**：测试文件和覆盖率配置
|
|
35
|
+
- **数据模型**：实体定义、数据库 schema、类型声明
|
|
36
|
+
- **质量工具**：ESLint、Prettier、TypeScript 配置
|
|
37
|
+
|
|
38
|
+
### 步骤 3：生成/更新 CLAUDE.md
|
|
39
|
+
|
|
40
|
+
**根级 `CLAUDE.md`** 包含：
|
|
41
|
+
- 项目愿景和简介（基于 $ARGUMENTS）
|
|
42
|
+
- 技术栈总览
|
|
43
|
+
- Mermaid 架构图
|
|
44
|
+
- 模块索引（名称 + 路径 + 一句话职责）
|
|
45
|
+
- 全局编码规范和约定
|
|
46
|
+
- 常用命令速查
|
|
47
|
+
|
|
48
|
+
**模块级 `<module>/CLAUDE.md`** 包含：
|
|
49
|
+
- 导航面包屑（`← 返回根 CLAUDE.md`）
|
|
50
|
+
- 模块职责描述
|
|
51
|
+
- 关键文件和入口
|
|
52
|
+
- 公开接口/API
|
|
53
|
+
- 依赖关系（上游和下游）
|
|
54
|
+
- 测试说明
|
|
55
|
+
|
|
56
|
+
### 步骤 4：aiGroup 框架适配
|
|
57
|
+
|
|
58
|
+
如果项目已安装 aiGroup 框架（存在 `.dev-agents/`）：
|
|
59
|
+
- 更新 `docs/ARCHITECTURE.md` 为实际架构
|
|
60
|
+
- 根据技术栈推荐 Jarvis 优先加载的技能
|
|
61
|
+
- 运行 `bash scripts/harness/run-all.sh` 健康检查
|
|
62
|
+
|
|
63
|
+
## 覆盖率与增量更新
|
|
64
|
+
|
|
65
|
+
- 输出"已扫描文件数 / 估算总文件数"和"已覆盖模块占比"
|
|
66
|
+
- 列出被忽略/跳过的原因和"建议下一步深挖的子路径"
|
|
67
|
+
- 重复运行 `/init-project` 时做**增量更新**与**断点续扫**，不覆盖用户自定义内容
|
|
68
|
+
|
|
69
|
+
## 安全与边界
|
|
70
|
+
|
|
71
|
+
- 只读/写文档与索引，**不改源代码**
|
|
72
|
+
- 默认忽略 `node_modules`、`dist`、`build`、`.git`、二进制文件等生成物
|
|
73
|
+
- 结果在主对话打印摘要，全文写入仓库
|
|
74
|
+
|
|
75
|
+
## 输出要求
|
|
76
|
+
|
|
77
|
+
在主对话中打印"初始化结果摘要"：
|
|
78
|
+
1. 根级 `CLAUDE.md` 是否创建/更新、主要栏目概览
|
|
79
|
+
2. 识别的模块数量及路径列表
|
|
80
|
+
3. 每个模块 `CLAUDE.md` 的生成/更新情况
|
|
81
|
+
4. 已生成 Mermaid 结构图和导航面包屑数量
|
|
82
|
+
5. 覆盖率与主要缺口
|
|
83
|
+
6. 若未读全：说明原因，并列出推荐的下一步
|
|
@@ -37,9 +37,12 @@ $ARGUMENTS
|
|
|
37
37
|
|
|
38
38
|
1. **必读** → `skills/kyle/tdd-guide/SKILL.md`（TDD 工作流和测试模式）
|
|
39
39
|
2. **必读** → `skills/max/workflow/verification-before-completion/SKILL.md`（完成验证规范）
|
|
40
|
-
3. **按需** → `skills/jarvis/
|
|
41
|
-
4. **按需** → `skills/jarvis/
|
|
42
|
-
5.
|
|
40
|
+
3. **按需** → `skills/jarvis/fullstack-guardian/SKILL.md`（全栈安全开发，涉及前后端集成时读取）
|
|
41
|
+
4. **按需** → `skills/jarvis/api-designer/SKILL.md`（API 设计，涉及 REST/GraphQL 时读取）
|
|
42
|
+
5. **按需** → `skills/jarvis/architecture-designer/SKILL.md`（系统架构设计，涉及架构决策时读取）
|
|
43
|
+
6. **Bug 修复时** → `skills/max/workflow/systematic-debugging/SKILL.md`
|
|
44
|
+
|
|
45
|
+
完整技能列表见 `.dev-agents/jarvis/PERSONA.md` 的技能加载表，根据任务类型按需读取 1-3 个最相关的 SKILL.md。
|
|
43
46
|
|
|
44
47
|
## 工作规范
|
|
45
48
|
|