ai-dev-analytics 1.1.12 → 2.0.1
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/README.en.md +51 -57
- package/README.md +68 -485
- package/dist/cli/commands/doctor.d.ts +2 -0
- package/dist/cli/commands/doctor.d.ts.map +1 -0
- package/dist/cli/commands/doctor.js +125 -0
- package/dist/cli/commands/doctor.js.map +1 -0
- package/dist/cli/commands/init.d.ts.map +1 -1
- package/dist/cli/commands/init.js +19 -176
- package/dist/cli/commands/init.js.map +1 -1
- package/dist/cli/commands/memory.d.ts.map +1 -1
- package/dist/cli/commands/memory.js +3 -13
- package/dist/cli/commands/memory.js.map +1 -1
- package/dist/cli/commands/rules.d.ts +0 -10
- package/dist/cli/commands/rules.d.ts.map +1 -1
- package/dist/cli/commands/rules.js +9 -34
- package/dist/cli/commands/rules.js.map +1 -1
- package/dist/cli/commands/skills.d.ts +0 -5
- package/dist/cli/commands/skills.d.ts.map +1 -1
- package/dist/cli/commands/skills.js +5 -24
- package/dist/cli/commands/skills.js.map +1 -1
- package/dist/cli/commands/sync.d.ts +2 -0
- package/dist/cli/commands/sync.d.ts.map +1 -0
- package/dist/cli/commands/sync.js +28 -0
- package/dist/cli/commands/sync.js.map +1 -0
- package/dist/cli/index.js +26 -85
- package/dist/cli/index.js.map +1 -1
- package/dist/{schemas/run-json.d.ts → internal/runtime/schema.d.ts} +4 -18
- package/dist/internal/runtime/schema.d.ts.map +1 -0
- package/dist/{schemas/run-json.js → internal/runtime/schema.js} +5 -9
- package/dist/internal/runtime/schema.js.map +1 -0
- package/dist/{utils/run-data.d.ts → internal/runtime/state.d.ts} +7 -8
- package/dist/internal/runtime/state.d.ts.map +1 -0
- package/dist/{utils/run-data.js → internal/runtime/state.js} +11 -12
- package/dist/internal/runtime/state.js.map +1 -0
- package/dist/internal/runtime/summary.d.ts +8 -0
- package/dist/internal/runtime/summary.d.ts.map +1 -0
- package/dist/internal/runtime/summary.js +260 -0
- package/dist/internal/runtime/summary.js.map +1 -0
- package/dist/internal/runtime/tokens.d.ts.map +1 -0
- package/dist/internal/runtime/tokens.js.map +1 -0
- package/dist/mcp/server.js +9 -8
- package/dist/mcp/server.js.map +1 -1
- package/dist/schemas/aida-project.d.ts +27 -1
- package/dist/schemas/aida-project.d.ts.map +1 -1
- package/dist/schemas/rules.d.ts +15 -0
- package/dist/schemas/rules.d.ts.map +1 -0
- package/dist/schemas/rules.js +5 -0
- package/dist/schemas/rules.js.map +1 -0
- package/dist/services/project-build.d.ts +44 -0
- package/dist/services/project-build.d.ts.map +1 -0
- package/dist/services/project-build.js +32 -0
- package/dist/services/project-build.js.map +1 -0
- package/dist/services/project-health.d.ts +14 -0
- package/dist/services/project-health.d.ts.map +1 -0
- package/dist/services/project-health.js +19 -0
- package/dist/services/project-health.js.map +1 -0
- package/dist/services/security-audit.d.ts +59 -0
- package/dist/services/security-audit.d.ts.map +1 -0
- package/dist/services/security-audit.js +638 -0
- package/dist/services/security-audit.js.map +1 -0
- package/dist/utils/ai-build.d.ts +3 -8
- package/dist/utils/ai-build.d.ts.map +1 -1
- package/dist/utils/ai-build.js +31 -117
- package/dist/utils/ai-build.js.map +1 -1
- package/dist/utils/guide.d.ts +3 -3
- package/dist/utils/guide.d.ts.map +1 -1
- package/dist/utils/guide.js +91 -68
- package/dist/utils/guide.js.map +1 -1
- package/dist/utils/import.d.ts.map +1 -1
- package/dist/utils/import.js +4 -15
- package/dist/utils/import.js.map +1 -1
- package/dist/utils/memory.d.ts +2 -0
- package/dist/utils/memory.d.ts.map +1 -1
- package/dist/utils/memory.js +440 -95
- package/dist/utils/memory.js.map +1 -1
- package/dist/utils/paths.d.ts +2 -10
- package/dist/utils/paths.d.ts.map +1 -1
- package/dist/utils/paths.js +5 -17
- package/dist/utils/paths.js.map +1 -1
- package/dist/utils/project-health.d.ts +39 -0
- package/dist/utils/project-health.d.ts.map +1 -0
- package/dist/utils/project-health.js +286 -0
- package/dist/utils/project-health.js.map +1 -0
- package/dist/utils/registry.d.ts +11 -0
- package/dist/utils/registry.d.ts.map +1 -0
- package/dist/utils/registry.js +65 -0
- package/dist/utils/registry.js.map +1 -0
- package/dist/utils/rules.d.ts +11 -1
- package/dist/utils/rules.d.ts.map +1 -1
- package/dist/utils/rules.js +76 -8
- package/dist/utils/rules.js.map +1 -1
- package/dist/utils/skills.d.ts +6 -9
- package/dist/utils/skills.d.ts.map +1 -1
- package/dist/utils/skills.js +26 -54
- package/dist/utils/skills.js.map +1 -1
- package/package.json +12 -14
- package/dist/cli/commands/build.d.ts +0 -2
- package/dist/cli/commands/build.d.ts.map +0 -1
- package/dist/cli/commands/build.js +0 -56
- package/dist/cli/commands/build.js.map +0 -1
- package/dist/cli/commands/dashboard.d.ts +0 -2
- package/dist/cli/commands/dashboard.d.ts.map +0 -1
- package/dist/cli/commands/dashboard.js +0 -70
- package/dist/cli/commands/dashboard.js.map +0 -1
- package/dist/cli/commands/import.d.ts +0 -2
- package/dist/cli/commands/import.d.ts.map +0 -1
- package/dist/cli/commands/import.js +0 -71
- package/dist/cli/commands/import.js.map +0 -1
- package/dist/cli/commands/log.d.ts +0 -2
- package/dist/cli/commands/log.d.ts.map +0 -1
- package/dist/cli/commands/log.js +0 -440
- package/dist/cli/commands/log.js.map +0 -1
- package/dist/cli/commands/merge-data.d.ts +0 -20
- package/dist/cli/commands/merge-data.d.ts.map +0 -1
- package/dist/cli/commands/merge-data.js +0 -574
- package/dist/cli/commands/merge-data.js.map +0 -1
- package/dist/cli/commands/merge.d.ts +0 -2
- package/dist/cli/commands/merge.d.ts.map +0 -1
- package/dist/cli/commands/merge.js +0 -82
- package/dist/cli/commands/merge.js.map +0 -1
- package/dist/cli/commands/migrate-dir.d.ts +0 -6
- package/dist/cli/commands/migrate-dir.d.ts.map +0 -1
- package/dist/cli/commands/migrate-dir.js +0 -125
- package/dist/cli/commands/migrate-dir.js.map +0 -1
- package/dist/cli/commands/migrate-legacy.d.ts +0 -2
- package/dist/cli/commands/migrate-legacy.d.ts.map +0 -1
- package/dist/cli/commands/migrate-legacy.js +0 -143
- package/dist/cli/commands/migrate-legacy.js.map +0 -1
- package/dist/cli/commands/migrate.d.ts +0 -2
- package/dist/cli/commands/migrate.d.ts.map +0 -1
- package/dist/cli/commands/migrate.js +0 -300
- package/dist/cli/commands/migrate.js.map +0 -1
- package/dist/cli/commands/reindex.d.ts +0 -14
- package/dist/cli/commands/reindex.d.ts.map +0 -1
- package/dist/cli/commands/reindex.js +0 -139
- package/dist/cli/commands/reindex.js.map +0 -1
- package/dist/cli/commands/report.d.ts +0 -2
- package/dist/cli/commands/report.d.ts.map +0 -1
- package/dist/cli/commands/report.js +0 -219
- package/dist/cli/commands/report.js.map +0 -1
- package/dist/cli/commands/start.d.ts +0 -2
- package/dist/cli/commands/start.d.ts.map +0 -1
- package/dist/cli/commands/start.js +0 -155
- package/dist/cli/commands/start.js.map +0 -1
- package/dist/cli/commands/status.d.ts +0 -2
- package/dist/cli/commands/status.d.ts.map +0 -1
- package/dist/cli/commands/status.js +0 -70
- package/dist/cli/commands/status.js.map +0 -1
- package/dist/cli/commands/update.d.ts +0 -2
- package/dist/cli/commands/update.d.ts.map +0 -1
- package/dist/cli/commands/update.js +0 -73
- package/dist/cli/commands/update.js.map +0 -1
- package/dist/schemas/run-json.d.ts.map +0 -1
- package/dist/schemas/run-json.js.map +0 -1
- package/dist/server/api.d.ts +0 -30
- package/dist/server/api.d.ts.map +0 -1
- package/dist/server/api.js +0 -239
- package/dist/server/api.js.map +0 -1
- package/dist/server/index.d.ts +0 -2
- package/dist/server/index.d.ts.map +0 -1
- package/dist/server/index.js +0 -228
- package/dist/server/index.js.map +0 -1
- package/dist/utils/run-data.d.ts.map +0 -1
- package/dist/utils/run-data.js.map +0 -1
- package/dist/utils/tokens.d.ts.map +0 -1
- package/dist/utils/tokens.js.map +0 -1
- package/src/assets/skills/audit.md +0 -98
- package/src/assets/skills/bug-fixer.md +0 -43
- package/src/assets/skills/code-generator.md +0 -71
- package/src/assets/skills/commit-code.md +0 -67
- package/src/assets/skills/dashboard-generator.md +0 -65
- package/src/assets/skills/dev-flower.md +0 -85
- package/src/assets/skills/deviation-recorder.md +0 -83
- package/src/assets/skills/docx-to-markdown.md +0 -69
- package/src/assets/skills/mcp-reviewer.md +0 -38
- package/src/assets/skills/requirement-analyzer.md +0 -103
- package/src/assets/skills/rules-evolver.md +0 -47
- package/src/assets/skills/self-reviewer.md +0 -49
- package/src/assets/skills/task-splitter.md +0 -60
- package/src/assets/skills/workflow-orchestrator.md +0 -209
- package/src/assets/templates/demo-run.json +0 -910
- package/src/assets/templates/run.json +0 -63
- package/src/dashboard/assets/index-B8QcPcg7.css +0 -1
- package/src/dashboard/assets/index-DcAl6lhS.js +0 -111
- package/src/dashboard/demo/overview.json +0 -71
- package/src/dashboard/demo/run.en.json +0 -1169
- package/src/dashboard/demo/run.json +0 -2667
- package/src/dashboard/demo/run.zh.json +0 -1169
- package/src/dashboard/demo/runs.json +0 -19
- package/src/dashboard/index.html +0 -13
- /package/dist/{utils → internal/runtime}/tokens.d.ts +0 -0
- /package/dist/{utils → internal/runtime}/tokens.js +0 -0
|
@@ -1,98 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: audit
|
|
3
|
-
description: 扫描项目代码,生成与项目完全匹配的 AI 开发规范,写入 .aida/rules.json 并通过 build 分发。
|
|
4
|
-
globs: ['.claude/rules/**/*.md', '.cursor/rules/**/*.md', '.codex/rules/**/*.md', '.lingma/rules/**/*.md', 'CLAUDE.md', 'AGENTS.md']
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# audit (项目审计)
|
|
8
|
-
|
|
9
|
-
## 提示
|
|
10
|
-
|
|
11
|
-
此 Skill 由用户人工触发,不纳入 workflow-orchestrator 自动化流程。
|
|
12
|
-
|
|
13
|
-
## 角色
|
|
14
|
-
|
|
15
|
-
你是一个顶级的架构师,擅长通过分析现有项目代码库(逻辑、公共组件、业务组件)来沉淀自动化指令。你的目标是编写能让 AI 生成代码"如出一辙"的规则。
|
|
16
|
-
|
|
17
|
-
## 核心目标
|
|
18
|
-
|
|
19
|
-
通过扫描真实项目代码 + 分析现有规则,构建一套与项目完全匹配的 AI 开发规范体系,使 AI 生成代码一次通过率达到 90% 以上。
|
|
20
|
-
|
|
21
|
-
## 执行阶段
|
|
22
|
-
|
|
23
|
-
### 阶段一:加载现有规则
|
|
24
|
-
|
|
25
|
-
读取并理解项目现有的所有规则来源:
|
|
26
|
-
1. **AIDevOS 规则**:当前 AI 工具目录下由 `aida build` 生成的规则文件
|
|
27
|
-
2. **全局规则文件**:
|
|
28
|
-
- Claude Code 用户:`CLAUDE.md`
|
|
29
|
-
- Cursor 用户:`.cursor/rules/*/*.md`
|
|
30
|
-
|
|
31
|
-
### 阶段二:项目真实结构建模
|
|
32
|
-
|
|
33
|
-
1. 扫描范围(排除 node_modules/dist/build/.git)
|
|
34
|
-
2. 技术栈识别(框架、UI 库、状态管理、请求封装、路由模式)
|
|
35
|
-
3. 深度分析:
|
|
36
|
-
- 公共组件:使用方式、Props 约定、插槽设计
|
|
37
|
-
- API 封装:请求函数命名、参数传递、错误处理
|
|
38
|
-
- 状态管理:Store 结构、Action/Mutation 模式
|
|
39
|
-
- 路由模式:路由配置、权限控制、懒加载
|
|
40
|
-
- 类型系统:接口定义、泛型使用、枚举约定
|
|
41
|
-
- 样式方案:CSS Modules / Tailwind / CSS-in-JS
|
|
42
|
-
- i18n 方案:文案管理、语言切换、命名约定
|
|
43
|
-
|
|
44
|
-
### 阶段三:规则审计
|
|
45
|
-
|
|
46
|
-
对现有 `.aida/rules.json` 与工具分发规则进行审计:
|
|
47
|
-
- **重复检测**:语义重复、约束重复
|
|
48
|
-
- **冲突检测**:A 强制 vs B 禁止
|
|
49
|
-
- **失配检测**:引用不存在的组件/API
|
|
50
|
-
- **缺失关键约束**:对照真实代码,发现未覆盖的模式
|
|
51
|
-
|
|
52
|
-
### 阶段四:生成规则并直接写入
|
|
53
|
-
|
|
54
|
-
基于真实代码生成或更新 `.aida/rules.json` 中的规则:
|
|
55
|
-
|
|
56
|
-
| 文件 | 内容 |
|
|
57
|
-
|------|------|
|
|
58
|
-
| `code-style.md` | 编码风格:命名规范、文件组织、注释要求 |
|
|
59
|
-
| `component-usage.md` | 组件使用:UI 库组件选择、自定义组件约定、Props 传递 |
|
|
60
|
-
| `api-patterns.md` | API 封装:请求函数模式、错误处理、类型定义 |
|
|
61
|
-
| `state-management.md` | 状态管理:Store 结构、Action 命名、数据流 |
|
|
62
|
-
| `i18n-rules.md` | 国际化:文案位置、key 命名、禁止硬编码 |
|
|
63
|
-
| `architecture.md` | 架构约束:目录结构、模块划分、依赖关系 |
|
|
64
|
-
| `type-system.md` | 类型系统:接口定义、泛型使用、any 禁用 |
|
|
65
|
-
|
|
66
|
-
**所有规则必须**:
|
|
67
|
-
1. 基于真实项目代码(不臆造)
|
|
68
|
-
2. 可执行、可验证(不能是模糊建议)
|
|
69
|
-
3. 包含正确示例和错误示例
|
|
70
|
-
4. 引用真实存在的组件/API 路径
|
|
71
|
-
|
|
72
|
-
### 阶段五:输出确认
|
|
73
|
-
|
|
74
|
-
生成完成后输出:
|
|
75
|
-
```
|
|
76
|
-
✓ 已生成/更新 .aida/rules.json 中的规则,并可通过 aida build 分发:
|
|
77
|
-
- code-style.md
|
|
78
|
-
- component-usage.md
|
|
79
|
-
- api-patterns.md
|
|
80
|
-
- state-management.md
|
|
81
|
-
- i18n-rules.md
|
|
82
|
-
- architecture.md
|
|
83
|
-
- type-system.md
|
|
84
|
-
|
|
85
|
-
基于项目代码扫描,识别:
|
|
86
|
-
- 技术栈:[Vue 3 + TypeScript + Pinia + Element Plus]
|
|
87
|
-
- 请求封装:[src/api/request.ts]
|
|
88
|
-
- 公共组件:[src/components/common/]
|
|
89
|
-
- 状态管理:[src/store/]
|
|
90
|
-
```
|
|
91
|
-
|
|
92
|
-
## 质量控制原则
|
|
93
|
-
|
|
94
|
-
1. 所有结论必须基于真实代码
|
|
95
|
-
2. 不允许猜测组件、虚构 API 模式
|
|
96
|
-
3. 优化目标为"AI 生成代码一致性"
|
|
97
|
-
4. 所有规则必须可执行、可验证
|
|
98
|
-
5. 规则文件使用 Markdown 格式,结构清晰
|
|
@@ -1,43 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: bug-fixer
|
|
3
|
-
description: 处理自检不通过或测试产生的 Bug 缺陷。基于 review 结果或用户反馈进行专项修复,并将 Bug 记录写入 run.json.bugs[]。
|
|
4
|
-
globs: ['.aida/runs/*/*/run.json', '.claude/rules/**/*.md', '.cursor/rules/**/*.md', '.codex/rules/**/*.md', '.lingma/rules/**/*.md', 'CLAUDE.md', 'AGENTS.md']
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# bug-fixer (缺陷修复器)
|
|
8
|
-
|
|
9
|
-
> **铁律**:1) 修复后必须在 `run.json.bugs[]` 追加 Bug 记录并更新 `summary.bugCount` 2) 写入后输出 `✓ run.json updated: bugs[], summary` 3) 修复前必须回顾当前 AI 工具目录下的规则文件判断是否为规范偏离 4) 如属于 AI 偏差(非功能 Bug),建议用户使用 deviation-recorder 记录
|
|
10
|
-
|
|
11
|
-
## 角色
|
|
12
|
-
|
|
13
|
-
你是一个经验丰富的高级救火队长。你擅于快速定位由于规范不匹配、组件搭配错误或业务逻辑理解偏差导致的隐患代码,并给予重构性的精准修复。
|
|
14
|
-
|
|
15
|
-
## 路径约定
|
|
16
|
-
|
|
17
|
-
> **[run_id]**:当前需求/功能的唯一标识
|
|
18
|
-
> **[dev_name]**:通过 `git config user.name` 获取,转全小写并用 `-` 替换空格。
|
|
19
|
-
> **数据根目录**:`.aida/runs/[run_id]/[dev_name]/`
|
|
20
|
-
> **数据文件**:`run.json`
|
|
21
|
-
|
|
22
|
-
## 执行指令
|
|
23
|
-
|
|
24
|
-
1. **获取修复任务:**
|
|
25
|
-
- 读取 `run.json.reviews[]` 中最近一条 `result: "fail"` 的 review 记录,或从用户反馈中获取 Bug 描述。
|
|
26
|
-
|
|
27
|
-
2. **定位与分析:**
|
|
28
|
-
- 根据 Bug 的描述或错误堆栈,定位到具体的问题文件。
|
|
29
|
-
- 回顾项目所有规范,以识别是不是架构偏离问题导致的:
|
|
30
|
-
- **AIDevOS 规则**:当前 AI 工具目录下由 `aida build` 生成的规则文件
|
|
31
|
-
- **全局规则文件**:`CLAUDE.md`(Claude Code 项目)或 `.cursor/rules/*/*.md`(Cursor 项目)
|
|
32
|
-
|
|
33
|
-
3. **修复策略执行:**
|
|
34
|
-
- 严谨地修改问题代码。
|
|
35
|
-
- 修复完成后请求再次自检触发,保证没有产生衍生问题。
|
|
36
|
-
|
|
37
|
-
4. **记录反馈(强制,不可跳过):**
|
|
38
|
-
- 如果此 Bug 源于 AI 生成代码与用户期望的偏差,应建议用户使用 deviation-recorder 记录到 `run.json.deviations[]`。
|
|
39
|
-
- 调用以下 MCP 工具记录 Bug 和修复:
|
|
40
|
-
- **记录 Bug** → 调用 `aida_log_bug`,传入 `title`、`severity`(critical/high/medium/low)、`source`(self-review/testing/user-report)、`taskId`、`files`
|
|
41
|
-
- **修复后标记** → 调用 `aida_bug_fix`,传入 `id`(BUG-XX)、`fix`(修复方案描述)
|
|
42
|
-
- **记录文件变更** → 调用 `aida_log_files`(自动扫描 git diff,无需传参)
|
|
43
|
-
- 工具会自动更新 summary 统计和 timeline。
|
|
@@ -1,71 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: code-generator
|
|
3
|
-
description: 严格按照 run.json.tasks[] 和项目规范生成业务代码,并更新任务状态。
|
|
4
|
-
globs: ['.aida/runs/*/*/run.json', '.claude/rules/**/*.md', '.cursor/rules/**/*.md', '.codex/rules/**/*.md', '.lingma/rules/**/*.md', 'CLAUDE.md', 'AGENTS.md']
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# code-generator (代码生成器)
|
|
8
|
-
|
|
9
|
-
> **铁律**:1) 必须先读取项目所有规范再写代码(当前 AI 工具目录下的规则文件、`CLAUDE.md` 或 `AGENTS.md`) 2) 完成后必须更新 `run.json.tasks[].status` 和 `summary.completedTasks` 3) 写入后输出 `✓ run.json updated: tasks[], summary, files[]` 4) 禁止臆想不存在的 API / 组件 5) 禁止魔法字符串,文案必须走 i18n
|
|
10
|
-
|
|
11
|
-
## 角色
|
|
12
|
-
|
|
13
|
-
你是一个极其严谨的、深刻理解项目架构的高级工程师。你严格执行任务清单,产出百分之百符合架构要求的代码。
|
|
14
|
-
|
|
15
|
-
## 路径约定
|
|
16
|
-
|
|
17
|
-
> **[run_id]**:当前需求/功能的唯一标识
|
|
18
|
-
> **[dev_name]**:通过 `git config user.name` 获取,转全小写并用 `-` 替换空格。
|
|
19
|
-
> **数据根目录**:`.aida/runs/[run_id]/[dev_name]/`
|
|
20
|
-
> **数据文件**:`run.json`
|
|
21
|
-
|
|
22
|
-
## 执行指令
|
|
23
|
-
|
|
24
|
-
1. **确定当前任务并记录开始时间:**
|
|
25
|
-
|
|
26
|
-
- 读取 `run.json.tasks[]`。
|
|
27
|
-
- 寻找**第一个** `status: "pending"` 或 `status: "in-progress"` 的任务作为本次工作的核心目标。
|
|
28
|
-
- 如果所有任务 `status: "done"`,提示工作结束。
|
|
29
|
-
- **立即调用** `aida_task_start` MCP 工具,传入 `id`(如 TASK-01)和 `title`,记录任务开始时间用于耗时统计。
|
|
30
|
-
|
|
31
|
-
2. **强制规则加载与参考文档读取:**
|
|
32
|
-
|
|
33
|
-
**a) 读取项目规范(必须):**
|
|
34
|
-
- 仔细阅读项目所有规范:
|
|
35
|
-
- **AIDevOS 规则**:当前 AI 工具目录下由 `aida build` 生成的规则文件
|
|
36
|
-
- **全局规则文件**:`CLAUDE.md`(Claude Code 项目)或 `.cursor/rules/*/*.md`(Cursor 项目)
|
|
37
|
-
- 规范包括:编码风格、组件使用、API 封装、i18n、状态管理、架构约束等。
|
|
38
|
-
|
|
39
|
-
**b) 读取接口文档(如果存在):**
|
|
40
|
-
- 检查数据根目录下是否存在接口文档:
|
|
41
|
-
- `api.md` / `interface.md` / `接口文档.md`
|
|
42
|
-
- 如果当前任务涉及 API 调用,优先参考接口文档中的定义:
|
|
43
|
-
- 接口路径、请求方式、参数结构、响应格式
|
|
44
|
-
- 按照接口文档的定义生成 API 调用代码
|
|
45
|
-
- 如果没有接口文档,根据 `analysis.md` 中的推断或任务描述编写。
|
|
46
|
-
|
|
47
|
-
3. **编写代码:**
|
|
48
|
-
|
|
49
|
-
- 严格按照所选任务的需求生成/修改代码。
|
|
50
|
-
- **通用禁区:**
|
|
51
|
-
- 禁止不符合项目规范的代码模式(从 rules 读取具体约束)。
|
|
52
|
-
- 禁止魔法字符串,页面文本必须进 i18n 文件。
|
|
53
|
-
- 禁止使用项目约定之外的路径别名。
|
|
54
|
-
- 不要臆造或假定不存在的组件 API。
|
|
55
|
-
- 确保代码逻辑健壮(类型定义、异常处理、必要注释)。
|
|
56
|
-
|
|
57
|
-
4. **状态更新(强制,不可跳过):**
|
|
58
|
-
完成当前任务代码后,**必须按顺序**执行以下命令记录:
|
|
59
|
-
|
|
60
|
-
**a) 记录所有文件变更(必须,不能遗漏):**
|
|
61
|
-
调用 `aida_log_files` MCP 工具(自动扫描 git diff 记录所有文件变更,无需传参)。
|
|
62
|
-
|
|
63
|
-
**b) 标记任务完成:**
|
|
64
|
-
调用 `aida_task_done` MCP 工具,传入 `id`(如 TASK-01)。
|
|
65
|
-
|
|
66
|
-
工具会自动更新 summary.filesChanged、summary.linesAdded、timeline 和 files[] 数组。
|
|
67
|
-
|
|
68
|
-
**检查清单**:
|
|
69
|
-
- ✅ 所有新建/修改/删除的文件都已记录
|
|
70
|
-
- ✅ 行数统计准确
|
|
71
|
-
- ✅ 任务状态已标记完成
|
|
@@ -1,67 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: commit-code
|
|
3
|
-
description: 完整的代码提交流程:更新代码 -> 检测冲突 -> 生成 commit message -> 提交 -> 推送。
|
|
4
|
-
globs: []
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# commit-code (代码提交助手)
|
|
8
|
-
|
|
9
|
-
## 角色
|
|
10
|
-
|
|
11
|
-
你是一个严谨的代码提交助手,负责确保代码安全地提交和推送。
|
|
12
|
-
|
|
13
|
-
## 执行步骤
|
|
14
|
-
|
|
15
|
-
### 1. 获取当前分支信息
|
|
16
|
-
|
|
17
|
-
```bash
|
|
18
|
-
git branch --show-current
|
|
19
|
-
```
|
|
20
|
-
|
|
21
|
-
### 2. 检查远程分支并更新代码
|
|
22
|
-
|
|
23
|
-
1. `git fetch origin`
|
|
24
|
-
2. 检查远程分支是否存在:`git ls-remote --heads origin [branch_name]`
|
|
25
|
-
- 不存在 -> `git push -u origin [branch_name]`
|
|
26
|
-
- 存在 -> `git pull origin [branch_name]`
|
|
27
|
-
3. 检测冲突:
|
|
28
|
-
- 有冲突 -> 提示用户手动解决,停止执行
|
|
29
|
-
- 无冲突 -> 继续
|
|
30
|
-
|
|
31
|
-
### 3. 检查代码改动
|
|
32
|
-
|
|
33
|
-
- `git status` 检查是否有改动
|
|
34
|
-
- `git diff --stat` 获取改动统计
|
|
35
|
-
|
|
36
|
-
### 4. 生成提交信息
|
|
37
|
-
|
|
38
|
-
1. 读取需求信息(如果 `analysis.md` 存在)
|
|
39
|
-
2. 分析改动类型:feat / fix / refactor / docs / chore
|
|
40
|
-
3. 确定改动范围(scope):根据改动文件的主要目录
|
|
41
|
-
4. 生成格式化的 commit message:
|
|
42
|
-
|
|
43
|
-
```
|
|
44
|
-
<type>(<scope>): <简短描述>
|
|
45
|
-
|
|
46
|
-
<改动列表>
|
|
47
|
-
|
|
48
|
-
Closes #[branch_name]
|
|
49
|
-
```
|
|
50
|
-
|
|
51
|
-
### 5. 提交代码
|
|
52
|
-
|
|
53
|
-
```bash
|
|
54
|
-
git add .
|
|
55
|
-
git commit -m "<message>"
|
|
56
|
-
```
|
|
57
|
-
|
|
58
|
-
### 6. 推送到远程(需用户确认)
|
|
59
|
-
|
|
60
|
-
- 询问用户是否推送
|
|
61
|
-
- 确认后执行 `git push origin [branch_name]`
|
|
62
|
-
|
|
63
|
-
## 注意事项
|
|
64
|
-
|
|
65
|
-
1. 检测到冲突立即停止,提示用户手动解决
|
|
66
|
-
2. 必须用户确认才推送
|
|
67
|
-
3. 推送失败不影响本地提交
|
|
@@ -1,65 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: dashboard-generator
|
|
3
|
-
description: 根据 run.json 数据自动生成/更新数据看板。现已由 `aida dashboard` CLI 命令替代(实时 Web Dashboard)。
|
|
4
|
-
globs: ['.aida/runs/*/*/run.json']
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# dashboard-generator (数据看板生成器)
|
|
8
|
-
|
|
9
|
-
> **注意**:此 Skill 的功能已由 `aida dashboard` CLI 命令替代。CLI 命令启动本地 HTTP Server + SSE 实时推送,提供更好的可视化体验。以下文档保留作为参考。
|
|
10
|
-
|
|
11
|
-
## 角色
|
|
12
|
-
|
|
13
|
-
你是一个数据可视化专家。你的职责是读取 `run.json` 中的所有结构化数据,提取关键指标,生成或更新一份美观的 ECharts 深色主题数据看板(单文件 HTML)。
|
|
14
|
-
|
|
15
|
-
## 路径约定
|
|
16
|
-
|
|
17
|
-
> **[run_id]**:当前需求/功能的唯一标识
|
|
18
|
-
> **[dev_name]**:通过 `git config user.name` 获取,转全小写并用 `-` 替换空格。
|
|
19
|
-
> **数据根目录**:`.aida/runs/[run_id]/[dev_name]/`
|
|
20
|
-
> **数据源**:`run.json`(单一数据源)
|
|
21
|
-
|
|
22
|
-
## 数据源 (run.json 字段映射)
|
|
23
|
-
|
|
24
|
-
| JSON Path | 提取内容 |
|
|
25
|
-
|-----------|---------|
|
|
26
|
-
| `summary.totalTasks` / `summary.completedTasks` | 任务完成进度 |
|
|
27
|
-
| `workflow[]` | 阶段数、各阶段状态 |
|
|
28
|
-
| `deviations[]` | 偏差总数、根因分类、类别分布、涉及文件 |
|
|
29
|
-
| `bugs[]` | 缺陷总数、涉及文件 |
|
|
30
|
-
| `reviews[]` | 自检次数、通过/未通过数 |
|
|
31
|
-
| `files[]` | 文件变更数、热点文件 |
|
|
32
|
-
| `rules[]` | 已沉淀规则列表 |
|
|
33
|
-
| `meta.startTime` / `meta.endTime` | 开发周期 |
|
|
34
|
-
| `timeline[]` | 事件时间线 |
|
|
35
|
-
|
|
36
|
-
## 看板结构
|
|
37
|
-
|
|
38
|
-
### KPI 卡片行(6 列,可点击查看详情)
|
|
39
|
-
|
|
40
|
-
| 卡片 | 数据来源 | 颜色 |
|
|
41
|
-
|------|---------|------|
|
|
42
|
-
| Tasks Completed | summary.completedTasks / summary.totalTasks | green |
|
|
43
|
-
| Stage Progress | workflow 中 completed 数 / workflow 总数 | blue |
|
|
44
|
-
| Deviations | summary.deviationCount | orange |
|
|
45
|
-
| Bugs | summary.bugCount | red |
|
|
46
|
-
| Review Pass Rate | summary.reviewPassCount / summary.reviewCount | purple |
|
|
47
|
-
| Files Changed | summary.filesChanged | cyan |
|
|
48
|
-
|
|
49
|
-
### 图表区域
|
|
50
|
-
|
|
51
|
-
| 图表 | 类型 | 数据源 |
|
|
52
|
-
|------|------|--------|
|
|
53
|
-
| 各阶段任务完成情况 | horizontal bar | tasks[](按 stageName 分组) |
|
|
54
|
-
| 偏差根因分析 | pie (donut) | deviations[](按 rootCauseCategory 分组) |
|
|
55
|
-
| 偏差类别分布 | horizontal bar | deviations[](按 deviationCategory 分组) |
|
|
56
|
-
| 文件修改热点 | horizontal bar | files[](按 changeCount 排序) |
|
|
57
|
-
| 偏差与规则趋势 | bar + line (双轴) | deviations[] 数量 + rules[] 累计数 |
|
|
58
|
-
| 开发时间线 | timeline | timeline[] |
|
|
59
|
-
|
|
60
|
-
## 技术要求
|
|
61
|
-
|
|
62
|
-
- **ECharts CDN**:`https://cdn.jsdelivr.net/npm/echarts@5.5.0/dist/echarts.min.js`
|
|
63
|
-
- **深色主题**:背景 `#0f1923`,卡片 `#162231`,边框 `#1e2d3d`,文字 `#e0e6ed`
|
|
64
|
-
- **响应式**:`window.addEventListener('resize', ...)` 让图表自适应
|
|
65
|
-
- **无外部依赖**:除 ECharts CDN 外不依赖其他库
|
|
@@ -1,85 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: dev-flower
|
|
3
|
-
description: 母 Skill,用于初始化 aiDevOS 开发流程:生成 Skill 文件、Rules 占位、需求目录结构。现已由 `aida init` CLI 命令替代。
|
|
4
|
-
globs: []
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# dev-flower (初始化生成器 / 母 Skill)
|
|
8
|
-
|
|
9
|
-
> **注意**:此 Skill 的功能已由 `npx aida init` CLI 命令替代。以下文档保留作为参考。
|
|
10
|
-
|
|
11
|
-
## 角色
|
|
12
|
-
|
|
13
|
-
你是 aiDevOS 的脚手架生成器。你的职责是扫描当前项目,生成完整的 AI 开发流程基础设施。
|
|
14
|
-
|
|
15
|
-
## 执行步骤
|
|
16
|
-
|
|
17
|
-
### 1. 扫描项目
|
|
18
|
-
|
|
19
|
-
- 读取当前项目源码、依赖和已有规则
|
|
20
|
-
- 排除目录:node_modules、dist
|
|
21
|
-
- 识别技术栈:框架、UI 组件库、状态管理、路由模式
|
|
22
|
-
|
|
23
|
-
### 2. 检查已有 Skill
|
|
24
|
-
|
|
25
|
-
需要生成的 Skill 列表(14 个):
|
|
26
|
-
- workflow-orchestrator
|
|
27
|
-
- requirement-analyzer
|
|
28
|
-
- task-splitter
|
|
29
|
-
- code-generator
|
|
30
|
-
- self-reviewer
|
|
31
|
-
- bug-fixer
|
|
32
|
-
- deviation-recorder
|
|
33
|
-
- dashboard-generator
|
|
34
|
-
- commit-code
|
|
35
|
-
- docx-to-markdown
|
|
36
|
-
- mcp-reviewer
|
|
37
|
-
- rules-evolver
|
|
38
|
-
- dev-flower
|
|
39
|
-
- audit
|
|
40
|
-
|
|
41
|
-
遍历列表:
|
|
42
|
-
- 如果 `.aida/skills.json` 中已存在同名 skill -> 跳过
|
|
43
|
-
- 如果不存在 -> 创建
|
|
44
|
-
|
|
45
|
-
### 3. 创建目录结构
|
|
46
|
-
|
|
47
|
-
```
|
|
48
|
-
.aida/
|
|
49
|
-
skills/ # Skill 定义(14 个)
|
|
50
|
-
rules/ # 项目规范
|
|
51
|
-
iron-rules.md # 铁律(不可违反)
|
|
52
|
-
runs/ # 需求运行实例
|
|
53
|
-
[branch_name]/
|
|
54
|
-
[dev_name]/
|
|
55
|
-
run.json # 单一数据源(所有结构化数据)
|
|
56
|
-
prd.md # 用户输入的需求文档
|
|
57
|
-
analysis.md # AI 生成的需求分析报告
|
|
58
|
-
config.json # 全局配置
|
|
59
|
-
```
|
|
60
|
-
|
|
61
|
-
### 4. 初始化 Rules 文件
|
|
62
|
-
|
|
63
|
-
在 `.aida/rules.json` 中生成初始铁律,再通过 `aida build` 分发到各 AI 工具目录。
|
|
64
|
-
|
|
65
|
-
### 5. 初始化需求文件夹
|
|
66
|
-
|
|
67
|
-
- 创建 `runs/[branch_name]/[dev_name]/` 目录
|
|
68
|
-
- 初始化 `run.json`(使用标准模板,包含 meta, summary, tasks, bugs, deviations, reviews, workflow, files, metrics, timeline, events, rules, context, extensions 15 个顶层字段)
|
|
69
|
-
- 创建 `prd.md` 和 `analysis.md` 占位文件
|
|
70
|
-
|
|
71
|
-
### 6. 生成 config.json
|
|
72
|
-
|
|
73
|
-
```json
|
|
74
|
-
{
|
|
75
|
-
"schemaVersion": "1.0",
|
|
76
|
-
"aiTool": "claude-code | cursor",
|
|
77
|
-
"project": "项目名称"
|
|
78
|
-
}
|
|
79
|
-
```
|
|
80
|
-
|
|
81
|
-
### 7. 完成提示
|
|
82
|
-
|
|
83
|
-
- 输出已生成的 Skill 列表
|
|
84
|
-
- 提示用户补充 rules 内容
|
|
85
|
-
- 提示用户使用 `workflow-orchestrator` 开始开发闭环
|
|
@@ -1,83 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: deviation-recorder
|
|
3
|
-
description: 记录 AI 代码生成产出与用户实际期望之间的偏差,修复代码并写入 run.json.deviations[],用于后续数据分析和规则优化。
|
|
4
|
-
globs: ['.aida/runs/*/*/run.json', '.claude/rules/**/*.md', '.cursor/rules/**/*.md', '.codex/rules/**/*.md', '.lingma/rules/**/*.md', 'CLAUDE.md', 'AGENTS.md']
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# deviation-recorder (偏差记录器)
|
|
8
|
-
|
|
9
|
-
> **铁律**:1) 必须在 `run.json.deviations[]` 追加偏差记录并更新 `summary.deviationCount`(不可跳过) 2) 写入后输出 `✓ run.json updated: deviations[], summary` 3) 偏差是无业务逻辑的技术规范时必须沉淀规则到 `.aida/rules.json` 并记录到 `run.json.rules[]` 4) 必须明确 rootCauseCategory 和 deviationCategory(不能留空)
|
|
10
|
-
|
|
11
|
-
## 角色
|
|
12
|
-
|
|
13
|
-
你是一个注重细节的产品质量分析师。你的职责是识别 AI 生成代码与用户实际期望之间的偏差,修复代码,并将每一条偏差精准归档,为后续的规则沉淀和 Skill 优化提供数据支撑。
|
|
14
|
-
|
|
15
|
-
## 路径约定
|
|
16
|
-
|
|
17
|
-
> **[run_id]**:当前需求/功能的唯一标识
|
|
18
|
-
> **[dev_name]**:通过 `git config user.name` 获取,转全小写并用 `-` 替换空格。
|
|
19
|
-
> **数据根目录**:`.aida/runs/[run_id]/[dev_name]/`
|
|
20
|
-
> **数据文件**:`run.json`
|
|
21
|
-
|
|
22
|
-
## 提示
|
|
23
|
-
|
|
24
|
-
此 Skill 由用户手动触发,不纳入 workflow-orchestrator 自动化流程。
|
|
25
|
-
|
|
26
|
-
## 与 bug-fixer 的区别
|
|
27
|
-
|
|
28
|
-
| 维度 | deviation-recorder | bug-fixer |
|
|
29
|
-
|------|-------------------|-----------|
|
|
30
|
-
| 触发场景 | AI 生成代码与用户期望不符(设计偏差、规则缺失、臆想) | 测试阶段发现的功能 Bug、报错、逻辑错误 |
|
|
31
|
-
| 记录位置 | `run.json.deviations[]` | `run.json.bugs[]` |
|
|
32
|
-
| 目的 | 驱动规则和 Skill 持续优化 | 修复缺陷保证功能正确 |
|
|
33
|
-
|
|
34
|
-
## 执行指令
|
|
35
|
-
|
|
36
|
-
1. **接收偏差描述:**
|
|
37
|
-
- 从用户的反馈中提取:AI 实际产出了什么 vs 用户期望是什么。
|
|
38
|
-
|
|
39
|
-
2. **定位与分析:**
|
|
40
|
-
- 根据偏差描述,定位到具体的问题文件。
|
|
41
|
-
- 回顾项目所有规范,判断是否为规则缺失或 AI 臆想导致:
|
|
42
|
-
- **AIDevOS 规则**:当前 AI 工具目录下由 `aida build` 生成的规则文件
|
|
43
|
-
- **全局规则文件**:`CLAUDE.md`(Claude Code 项目)或 `.cursor/rules/*/*.md`(Cursor 项目)
|
|
44
|
-
|
|
45
|
-
3. **修复代码:**
|
|
46
|
-
- 严谨地修改偏差代码,使其符合用户期望。
|
|
47
|
-
|
|
48
|
-
4. **记录偏差(强制,不可跳过):**
|
|
49
|
-
调用 `aida_log_deviation` MCP 工具,传入以下参数:
|
|
50
|
-
- `title`:偏差简述
|
|
51
|
-
- `rootCause`:根因分类,可选值:`rule-missing`, `context-insufficient`, `hallucination`, `misunderstanding`, `reference-copy`, `process-omission`, `other`
|
|
52
|
-
- `category`:偏差类别,可选值:`ui-spacing`, `layout`, `component-usage`, `i18n`, `api`, `logic`, `architecture`, `style`, `other`
|
|
53
|
-
- `aiOutput`:AI 实际生成了什么
|
|
54
|
-
- `expected`:用户实际想要什么
|
|
55
|
-
- `files`:涉及的文件路径(逗号分隔)
|
|
56
|
-
工具会自动生成 `DEV-XX` 编号并更新 summary 统计。
|
|
57
|
-
|
|
58
|
-
5. **规则沉淀(仅限无业务逻辑的技术规范):**
|
|
59
|
-
|
|
60
|
-
**判断是否需要沉淀:** 如果偏差根因是 `rule-missing`,必须判断这个修复方案是**技术规范**还是**业务逻辑**。
|
|
61
|
-
|
|
62
|
-
**关键判断标准:**
|
|
63
|
-
- ✅ **需要沉淀**:无业务逻辑的项目代码级规范(组件使用、API 封装、代码规范等)
|
|
64
|
-
- ❌ **不需要沉淀**:带有业务逻辑的功能实现(特定业务需求、功能定制等)
|
|
65
|
-
|
|
66
|
-
**示例对比:**
|
|
67
|
-
- ✅ "el-dialog 内 Table 必须有 min-height 容器" ← 组件使用规范,需要沉淀
|
|
68
|
-
- ✅ "API 请求必须走统一封装层" ← API 使用规范,需要沉淀
|
|
69
|
-
- ❌ "用户列表需要显示注册时间字段" ← 业务需求,不需要沉淀
|
|
70
|
-
- ❌ "订单详情页需要增加物流信息" ← 业务逻辑,不需要沉淀
|
|
71
|
-
|
|
72
|
-
**a) 无业务逻辑 → 沉淀规则:**
|
|
73
|
-
- 如果是**技术规范**(无业务逻辑),询问用户确认后,调用 `aida_log_rule` MCP 工具:
|
|
74
|
-
- `content`: 规则描述
|
|
75
|
-
- `category`: 分类(可选值:`component`, `api`, `style`, `i18n`, `architecture`, `state-management`, `routing`, `testing`, `process`, `general`)
|
|
76
|
-
- `sourceDeviation`: 关联的偏差 ID(如 DEV-XX)
|
|
77
|
-
- 规则会自动写入 `.aida/rules.json`(项目级注册表),并通过 fingerprint 自动去重
|
|
78
|
-
- 工具会自动重建各 AI 工具目录下的规则文件
|
|
79
|
-
|
|
80
|
-
**c) 带业务逻辑 → 不创建规则:**
|
|
81
|
-
- 如果是**业务逻辑**(特定功能需求),不创建规则,只记录偏差即可。
|
|
82
|
-
|
|
83
|
-
**注意**:规则的 source of truth 是 `.aida/rules.json`(提交到 git),各 AI 工具目录下的规则文件是自动生成的分发产物(已 gitignore)。并行分支的规则通过 fingerprint 自动去重,合并冲突可用 `aida rules merge` 解决。
|
|
@@ -1,69 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: docx-to-markdown
|
|
3
|
-
description: 将 .docx 文件转换为 Markdown 格式,支持文本、标题、列表、表格、图片等元素。
|
|
4
|
-
globs: ['**/*.docx']
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# docx-to-markdown (文档转换器)
|
|
8
|
-
|
|
9
|
-
## 角色
|
|
10
|
-
|
|
11
|
-
你是一个文档格式转换工具,负责将 .docx 文件转换为开发流程可用的 Markdown 格式。
|
|
12
|
-
|
|
13
|
-
## 执行步骤
|
|
14
|
-
|
|
15
|
-
### 1. 检查可用转换工具
|
|
16
|
-
|
|
17
|
-
优先级:pandoc > mammoth > python-docx
|
|
18
|
-
|
|
19
|
-
```bash
|
|
20
|
-
which pandoc # 推荐
|
|
21
|
-
which mammoth # 备选
|
|
22
|
-
python3 -c "import docx" 2>/dev/null # 最后备选
|
|
23
|
-
```
|
|
24
|
-
|
|
25
|
-
### 2. 执行转换
|
|
26
|
-
|
|
27
|
-
#### 使用 pandoc(推荐)
|
|
28
|
-
|
|
29
|
-
```bash
|
|
30
|
-
pandoc "[input.docx]" -o "[output.md]" --extract-media="./media" --wrap=none
|
|
31
|
-
```
|
|
32
|
-
|
|
33
|
-
#### 使用 mammoth
|
|
34
|
-
|
|
35
|
-
```bash
|
|
36
|
-
mammoth "[input.docx]" "[output.md]"
|
|
37
|
-
```
|
|
38
|
-
|
|
39
|
-
### 3. 后处理
|
|
40
|
-
|
|
41
|
-
- 清理多余空行
|
|
42
|
-
- 确保标题格式正确
|
|
43
|
-
- 修复列表缩进
|
|
44
|
-
- 确保表格格式正确
|
|
45
|
-
- 处理图片路径
|
|
46
|
-
|
|
47
|
-
### 4. 验证
|
|
48
|
-
|
|
49
|
-
```bash
|
|
50
|
-
if [ -f "$MD_FILE" ]; then
|
|
51
|
-
echo "转换成功: $MD_FILE"
|
|
52
|
-
fi
|
|
53
|
-
```
|
|
54
|
-
|
|
55
|
-
## 支持的元素
|
|
56
|
-
|
|
57
|
-
- 标题(H1-H6)、段落、列表(有序/无序)、表格
|
|
58
|
-
- 粗体、斜体、图片(提取到 media 目录)
|
|
59
|
-
- 复杂格式和嵌入对象可能部分丢失
|
|
60
|
-
|
|
61
|
-
## 安装依赖
|
|
62
|
-
|
|
63
|
-
```bash
|
|
64
|
-
# macOS
|
|
65
|
-
brew install pandoc
|
|
66
|
-
|
|
67
|
-
# 或使用 npm
|
|
68
|
-
npm install -g mammoth
|
|
69
|
-
```
|
|
@@ -1,38 +0,0 @@
|
|
|
1
|
-
---
|
|
2
|
-
name: mcp-reviewer
|
|
3
|
-
description: 使用外部审查工具或人类代码审查结果进行更高安全级别的审计,结果写入 run.json.reviews[]。
|
|
4
|
-
globs: ['.aida/runs/*/*/run.json']
|
|
5
|
-
---
|
|
6
|
-
|
|
7
|
-
# mcp-reviewer (高级审查员)
|
|
8
|
-
|
|
9
|
-
## 提示
|
|
10
|
-
|
|
11
|
-
此 Skill 由用户人工触发,不纳入 workflow-orchestrator 自动化流程。
|
|
12
|
-
|
|
13
|
-
## 角色
|
|
14
|
-
|
|
15
|
-
你是一个跨界安全与代码架构专家,专门介入和审查系统自动工具可能忽略到的架构风险、深层次的安全隐患和性能瓶颈。
|
|
16
|
-
|
|
17
|
-
## 适用场景
|
|
18
|
-
|
|
19
|
-
- 核心底层模块重构(Hooks/Store/API)
|
|
20
|
-
- 涉及敏感权限交互和数据流边界
|
|
21
|
-
- 人类架构师指定的 Review Request
|
|
22
|
-
|
|
23
|
-
## 路径约定
|
|
24
|
-
|
|
25
|
-
> **数据根目录**:`.aida/runs/[run_id]/[dev_name]/`
|
|
26
|
-
> **数据文件**:`run.json`
|
|
27
|
-
|
|
28
|
-
## 执行说明
|
|
29
|
-
|
|
30
|
-
1. 该 Skill 需要人工参与并主动触发。
|
|
31
|
-
2. 读取指定的代码变更和结构分析。
|
|
32
|
-
3. 产出详尽的高级审查结果,内容需要包含:安全审查、性能预警和可维护性健康度三块。
|
|
33
|
-
4. 调用 `aida_log_review` MCP 工具记录审查结果:
|
|
34
|
-
- **通过时**:传入 `result: "pass"`、`scope`(审查覆盖的模块)
|
|
35
|
-
- **未通过时**:传入 `result: "fail"`、`scope`、`issues`(逗号分隔的问题描述)
|
|
36
|
-
5. 基于审查结果,如需生成改进任务:
|
|
37
|
-
- 调用 `aida_task_start` MCP 工具,传入 `title`(改进任务描述)、`stage`(如 "安全加固")
|
|
38
|
-
- 工具会自动更新 summary 统计和 timeline。
|