aidevo 1.0.0-beta.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.
Files changed (110) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +431 -0
  3. package/dist/cli/commands/dashboard.d.ts +2 -0
  4. package/dist/cli/commands/dashboard.d.ts.map +1 -0
  5. package/dist/cli/commands/dashboard.js +70 -0
  6. package/dist/cli/commands/dashboard.js.map +1 -0
  7. package/dist/cli/commands/init.d.ts +2 -0
  8. package/dist/cli/commands/init.d.ts.map +1 -0
  9. package/dist/cli/commands/init.js +362 -0
  10. package/dist/cli/commands/init.js.map +1 -0
  11. package/dist/cli/commands/log.d.ts +2 -0
  12. package/dist/cli/commands/log.d.ts.map +1 -0
  13. package/dist/cli/commands/log.js +438 -0
  14. package/dist/cli/commands/log.js.map +1 -0
  15. package/dist/cli/commands/migrate.d.ts +2 -0
  16. package/dist/cli/commands/migrate.d.ts.map +1 -0
  17. package/dist/cli/commands/migrate.js +183 -0
  18. package/dist/cli/commands/migrate.js.map +1 -0
  19. package/dist/cli/commands/reindex.d.ts +10 -0
  20. package/dist/cli/commands/reindex.d.ts.map +1 -0
  21. package/dist/cli/commands/reindex.js +94 -0
  22. package/dist/cli/commands/reindex.js.map +1 -0
  23. package/dist/cli/commands/report.d.ts +2 -0
  24. package/dist/cli/commands/report.d.ts.map +1 -0
  25. package/dist/cli/commands/report.js +219 -0
  26. package/dist/cli/commands/report.js.map +1 -0
  27. package/dist/cli/commands/rules.d.ts +2 -0
  28. package/dist/cli/commands/rules.d.ts.map +1 -0
  29. package/dist/cli/commands/rules.js +143 -0
  30. package/dist/cli/commands/rules.js.map +1 -0
  31. package/dist/cli/commands/start.d.ts +2 -0
  32. package/dist/cli/commands/start.d.ts.map +1 -0
  33. package/dist/cli/commands/start.js +173 -0
  34. package/dist/cli/commands/start.js.map +1 -0
  35. package/dist/cli/commands/status.d.ts +2 -0
  36. package/dist/cli/commands/status.d.ts.map +1 -0
  37. package/dist/cli/commands/status.js +74 -0
  38. package/dist/cli/commands/status.js.map +1 -0
  39. package/dist/cli/commands/update.d.ts +2 -0
  40. package/dist/cli/commands/update.d.ts.map +1 -0
  41. package/dist/cli/commands/update.js +146 -0
  42. package/dist/cli/commands/update.js.map +1 -0
  43. package/dist/cli/index.d.ts +3 -0
  44. package/dist/cli/index.d.ts.map +1 -0
  45. package/dist/cli/index.js +85 -0
  46. package/dist/cli/index.js.map +1 -0
  47. package/dist/mcp/server.d.ts +10 -0
  48. package/dist/mcp/server.d.ts.map +1 -0
  49. package/dist/mcp/server.js +632 -0
  50. package/dist/mcp/server.js.map +1 -0
  51. package/dist/schemas/run-json.d.ts +252 -0
  52. package/dist/schemas/run-json.d.ts.map +1 -0
  53. package/dist/schemas/run-json.js +22 -0
  54. package/dist/schemas/run-json.js.map +1 -0
  55. package/dist/server/api.d.ts +24 -0
  56. package/dist/server/api.d.ts.map +1 -0
  57. package/dist/server/api.js +196 -0
  58. package/dist/server/api.js.map +1 -0
  59. package/dist/server/index.d.ts +2 -0
  60. package/dist/server/index.d.ts.map +1 -0
  61. package/dist/server/index.js +166 -0
  62. package/dist/server/index.js.map +1 -0
  63. package/dist/utils/display.d.ts +12 -0
  64. package/dist/utils/display.d.ts.map +1 -0
  65. package/dist/utils/display.js +52 -0
  66. package/dist/utils/display.js.map +1 -0
  67. package/dist/utils/fs.d.ts +9 -0
  68. package/dist/utils/fs.d.ts.map +1 -0
  69. package/dist/utils/fs.js +43 -0
  70. package/dist/utils/fs.js.map +1 -0
  71. package/dist/utils/git.d.ts +4 -0
  72. package/dist/utils/git.d.ts.map +1 -0
  73. package/dist/utils/git.js +18 -0
  74. package/dist/utils/git.js.map +1 -0
  75. package/dist/utils/paths.d.ts +25 -0
  76. package/dist/utils/paths.d.ts.map +1 -0
  77. package/dist/utils/paths.js +45 -0
  78. package/dist/utils/paths.js.map +1 -0
  79. package/dist/utils/rules.d.ts +44 -0
  80. package/dist/utils/rules.d.ts.map +1 -0
  81. package/dist/utils/rules.js +208 -0
  82. package/dist/utils/rules.js.map +1 -0
  83. package/dist/utils/run-data.d.ts +37 -0
  84. package/dist/utils/run-data.d.ts.map +1 -0
  85. package/dist/utils/run-data.js +353 -0
  86. package/dist/utils/run-data.js.map +1 -0
  87. package/dist/utils/tokens.d.ts +26 -0
  88. package/dist/utils/tokens.d.ts.map +1 -0
  89. package/dist/utils/tokens.js +173 -0
  90. package/dist/utils/tokens.js.map +1 -0
  91. package/package.json +48 -0
  92. package/src/assets/skills/audit.md +98 -0
  93. package/src/assets/skills/bug-fixer.md +48 -0
  94. package/src/assets/skills/code-generator.md +82 -0
  95. package/src/assets/skills/commit-code.md +67 -0
  96. package/src/assets/skills/dashboard-generator.md +65 -0
  97. package/src/assets/skills/dev-flower.md +85 -0
  98. package/src/assets/skills/deviation-recorder.md +89 -0
  99. package/src/assets/skills/docx-to-markdown.md +69 -0
  100. package/src/assets/skills/mcp-reviewer.md +43 -0
  101. package/src/assets/skills/requirement-analyzer.md +103 -0
  102. package/src/assets/skills/rules-evolver.md +48 -0
  103. package/src/assets/skills/self-reviewer.md +53 -0
  104. package/src/assets/skills/task-splitter.md +58 -0
  105. package/src/assets/skills/workflow-orchestrator.md +204 -0
  106. package/src/assets/templates/demo-run.json +910 -0
  107. package/src/assets/templates/run.json +63 -0
  108. package/src/dashboard/assets/index-BMygHuaU.js +111 -0
  109. package/src/dashboard/assets/index-BW0UZ6Es.css +1 -0
  110. package/src/dashboard/index.html +13 -0
@@ -0,0 +1,85 @@
1
+ ---
2
+ name: dev-flower
3
+ description: 母 Skill,用于初始化 aiDevOS 开发流程:生成 Skill 文件、Rules 占位、需求目录结构。现已由 `aidevo init` CLI 命令替代。
4
+ globs: []
5
+ ---
6
+
7
+ # dev-flower (初始化生成器 / 母 Skill)
8
+
9
+ > **注意**:此 Skill 的功能已由 `npx aidevo 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
+ - 如果 `.aidevos/skills/[skill_name]/SKILL.md` 已存在 -> 跳过
43
+ - 如果不存在 -> 创建
44
+
45
+ ### 3. 创建目录结构
46
+
47
+ ```
48
+ .aidevos/
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
+ 在 `.aidevos/rules/` 下生成 `iron-rules.md`,包含 3 条铁律。
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` 开始开发闭环
@@ -0,0 +1,89 @@
1
+ ---
2
+ name: deviation-recorder
3
+ description: 记录 AI 代码生成产出与用户实际期望之间的偏差,修复代码并写入 run.json.deviations[],用于后续数据分析和规则优化。
4
+ globs: ['.aidevos/runs/*/*/run.json', '.aidevos/rules/*.md', 'CLAUDE.md', '.cursor/rules/*/*.md']
5
+ ---
6
+
7
+ # deviation-recorder (偏差记录器)
8
+
9
+ > **铁律**:1) 必须在 `run.json.deviations[]` 追加偏差记录并更新 `summary.deviationCount`(不可跳过) 2) 写入后输出 `✓ run.json updated: deviations[], summary` 3) 偏差是无业务逻辑的技术规范时必须沉淀规则到 `.aidevos/rules/` 并记录到 `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
+ > **数据根目录**:`.aidevos/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 规则**:`.aidevos/rules/` 下的所有 `.md` 文件
43
+ - **全局规则文件**:`CLAUDE.md`(Claude Code 项目)或 `.cursor/rules/*/*.md`(Cursor 项目)
44
+
45
+ 3. **修复代码:**
46
+ - 严谨地修改偏差代码,使其符合用户期望。
47
+
48
+ 4. **记录偏差(强制,不可跳过):**
49
+ 执行以下命令记录偏差:
50
+ ```bash
51
+ aidevo log deviation --title "偏差简述" --root-cause rule-missing --category component-usage --ai-output "AI实际生成了什么" --expected "用户实际想要什么" --files "file1.ts,file2.ts"
52
+ ```
53
+ `--root-cause` 可选值:`rule-missing`, `context-insufficient`, `hallucination`, `misunderstanding`, `reference-copy`, `process-omission`, `other`
54
+ `--category` 可选值:`ui-spacing`, `layout`, `component-usage`, `i18n`, `api`, `logic`, `architecture`, `style`, `other`
55
+ CLI 会自动生成 `DEV-XX` 编号并更新 summary 统计。
56
+
57
+ 5. **规则沉淀(仅限无业务逻辑的技术规范):**
58
+
59
+ **判断是否需要沉淀:** 如果偏差根因是 `rule-missing`,必须判断这个修复方案是**技术规范**还是**业务逻辑**。
60
+
61
+ **关键判断标准:**
62
+ - ✅ **需要沉淀**:无业务逻辑的项目代码级规范(组件使用、API 封装、代码规范等)
63
+ - ❌ **不需要沉淀**:带有业务逻辑的功能实现(特定业务需求、功能定制等)
64
+
65
+ **示例对比:**
66
+ - ✅ "el-dialog 内 Table 必须有 min-height 容器" ← 组件使用规范,需要沉淀
67
+ - ✅ "API 请求必须走统一封装层" ← API 使用规范,需要沉淀
68
+ - ❌ "用户列表需要显示注册时间字段" ← 业务需求,不需要沉淀
69
+ - ❌ "订单详情页需要增加物流信息" ← 业务逻辑,不需要沉淀
70
+
71
+ **a) 无业务逻辑 → 创建 pending 规则:**
72
+ - 如果是**技术规范**(无业务逻辑),立即创建 pending 规则:
73
+ ```bash
74
+ aidevo log rule --content "规则描述" --category component --source-deviation DEV-XX --status pending
75
+ ```
76
+ - `--category` 可选值:`component`, `api`, `style`, `i18n`, `architecture`, `state-management`, `routing`, `testing`, `process`, `general`
77
+ - 规则会自动写入 `.aidevos/rules.json`(项目级注册表),并通过 fingerprint 自动去重
78
+ - CLI 会自动重建 `.aidevos/rules/*.md` 视图文件
79
+
80
+ **b) 正式沉淀规则(去掉 pending):**
81
+ ```bash
82
+ aidevo log rule --content "正式规则内容" --category component --source-deviation DEV-XX
83
+ ```
84
+ - 不带 `--status pending` 即为正式沉淀,更新 `summary.rulesSedimented` 统计
85
+
86
+ **c) 带业务逻辑 → 不创建规则:**
87
+ - 如果是**业务逻辑**(特定功能需求),不创建规则,只记录偏差即可。
88
+
89
+ **注意**:规则的 source of truth 是 `.aidevos/rules.json`(提交到 git),`.aidevos/rules/*.md` 是自动生成的只读视图(已 gitignore)。并行分支的规则通过 fingerprint 自动去重,合并冲突可用 `aidevo rules merge` 解决。
@@ -0,0 +1,69 @@
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
+ ```
@@ -0,0 +1,43 @@
1
+ ---
2
+ name: mcp-reviewer
3
+ description: 使用外部审查工具或人类代码审查结果进行更高安全级别的审计,结果写入 run.json.reviews[]。
4
+ globs: ['.aidevos/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
+ > **数据根目录**:`.aidevos/runs/[run_id]/[dev_name]/`
26
+ > **数据文件**:`run.json`
27
+
28
+ ## 执行说明
29
+
30
+ 1. 该 Skill 需要人工参与并主动触发。
31
+ 2. 读取指定的代码变更和结构分析。
32
+ 3. 产出详尽的高级审查结果,内容需要包含:安全审查、性能预警和可维护性健康度三块。
33
+ 4. 执行以下命令记录审查结果:
34
+ ```bash
35
+ aidevo log review --result pass --scope "审查覆盖的模块" --issues 0
36
+ # 或
37
+ aidevo log review --result fail --scope "审查覆盖的模块" --issues 3
38
+ ```
39
+ 5. 基于审查结果,如需生成改进任务:
40
+ ```bash
41
+ aidevo log task --title "改进任务描述" --stage "安全加固"
42
+ ```
43
+ CLI 会自动更新 summary 统计和 timeline。
@@ -0,0 +1,103 @@
1
+ ---
2
+ name: requirement-analyzer
3
+ description: 分析需求文档,对比 PRD 与已有代码/规则,提取需实现的功能点及约束。
4
+ globs: ['.aidevos/runs/*/prd.md', '.aidevos/runs/*/prd*.md', '.aidevos/rules/*.md', 'CLAUDE.md', '.cursor/rules/*/*.md']
5
+ ---
6
+
7
+ # requirement-analyzer (需求分析器)
8
+
9
+ ## 角色
10
+
11
+ 你是一个经验丰富的架构师和需求分析师。你的任务是深入理解业务需求,结合项目现有的代码架构和规范,将业务需求转化为对开发具有指导意义的结构化分析报告。
12
+
13
+ ## 路径约定(v2 目录结构)
14
+
15
+ > **[run_id]**:当前需求/功能的唯一标识
16
+ > **[dev_name]**:通过 `git config user.name` 获取,转全小写并用 `-` 替换空格。
17
+ > **分支目录**:`.aidevos/runs/[run_id]/`(共享:prd.md、analysis.md、requirement.json)
18
+ > **开发者目录**:`.aidevos/runs/[run_id]/[dev_name]/`(个人:run.json)
19
+
20
+ ## 执行步骤
21
+
22
+ 1. **读取输入:**
23
+
24
+ **a) 读取需求文档:**
25
+ - 读取**分支目录**下的 `prd.md` 或相关产品需求文档。
26
+ - 如果已有 `analysis.md`,请基于其内容进行增量或补充分析,不要覆盖原有有效信息。
27
+
28
+ **b) 读取接口文档(如果存在):**
29
+ - 检查分支目录下是否存在接口文档:
30
+ - `api.md` / `interface.md` / `接口文档.md`
31
+ - 或其他包含接口定义的文档
32
+ - 如果存在接口文档,详细阅读其中的:
33
+ - 接口路径、请求方式(GET/POST/PUT/DELETE)
34
+ - 请求参数(query/body)和响应结构
35
+ - 接口说明和业务逻辑
36
+ - 接口文档是可选的,有则读取并融入分析,无则根据 PRD 推断
37
+
38
+ **c) 读取项目规范:**
39
+ - 读取项目所有规范,确保分析结果符合项目全局约束:
40
+ - **AIDevOS 规则**:`.aidevos/rules/` 下的所有 `.md` 文件
41
+ - **全局规则文件**:`CLAUDE.md`(Claude Code 项目)或 `.cursor/rules/*/*.md`(Cursor 项目)
42
+
43
+ 2. **提取核心信息:**
44
+
45
+ - **业务模块与路由:** 需求涉及哪些页面?层级架构和路由路径是什么?
46
+ - **核心功能点:** 将需求拆解为独立的核心功能模块(列表查询、表单交互、数据展示、状态流转等)。
47
+ - **API 需求:** 推断或确认需要调用的后端接口(请求方式、入参出参)。不明确的必须标记为待确认。
48
+ - **组件与 UI:** 涉及的 UI 元素,是否可以使用现有公共组件?需要新组件的应明确职责和位置。
49
+ - **状态管理:** 哪些数据需要在页面间共享或全局缓存?
50
+
51
+ 3. **遵循规范进行匹配:**
52
+
53
+ - 检查需求中的交互是否符合项目中现有的规范体系。
54
+ - 确认是否需要包含在多语言 (i18n) 范畴内。
55
+ - 如果需求描述与已有规范冲突,提出规范推荐方案。
56
+
57
+ 4. **生成输出文档并请求用户确认:**
58
+ - 将分析结果整理并输出到**分支目录**的 `analysis.md`。
59
+ - **关键流程控制点:** 生成 analysis.md 后**必须暂停**,等待用户确认对需求的理解是否正确。
60
+ - 输出提示:"📋 需求分析已完成,请确认以下理解是否准确:[分析要点摘要]"
61
+ - 等待用户明确回复 "✓ 确认理解正确" 或提出修正意见后,才能让 workflow 继续往下走。
62
+ - **禁止自动进入任务拆分阶段**,需求理解错误会导致后续所有环节全部偏离。
63
+
64
+ ## 输出模板 (analysis.md)
65
+
66
+ ```markdown
67
+ # 需求分析报告
68
+
69
+ ## 1. 业务概述
70
+
71
+ [简述需求的核心目的和业务价值]
72
+
73
+ ## 2. 功能模块清单
74
+
75
+ | 模块ID | 名称 | 描述 | 涉及页面/文件 |
76
+ |--------|------|------|-------------|
77
+ | MOD-01 | [模块名] | [功能描述] | [页面路径或文件位置] |
78
+ | MOD-02 | [模块名] | [功能描述] | [页面路径或文件位置] |
79
+
80
+ ## 3. 页面与路由规划
81
+
82
+ - 页面 A:[路径/组件位置]
83
+ - 页面 B:[路径/组件位置]
84
+
85
+ ## 4. 功能点拆解
86
+
87
+ 1. [功能点 1 名称]
88
+ - 描述:[详细交互说明]
89
+ - 所属模块:MOD-XX
90
+ - 依赖 API:[接口路径或说明]
91
+ - 组件选型:[使用的公共组件]
92
+ 2. [功能点 2 名称]...
93
+
94
+ ## 5. 规范一致性检查
95
+
96
+ - **UI/组件规范:** [确认符合规范/需新建组件]
97
+ - **i18n 规范:** [需要添加的语言包模块]
98
+ - **API 封装规范:** [遵循统一请求约束]
99
+
100
+ ## 6. 待确认或风险项 (非常重要)
101
+
102
+ - [列出所有需要确认的设计细节、字段、接口边界等]
103
+ ```
@@ -0,0 +1,48 @@
1
+ ---
2
+ name: rules-evolver
3
+ description: 根据日常开发过程中遇到的普遍问题、PR 意见、架构升级,维护并沉淀本地项目开发规范。
4
+ globs: ['.aidevos/rules/*.md', 'CLAUDE.md', '.cursor/rules/*/*.md']
5
+ ---
6
+
7
+ # rules-evolver (规范演进者)
8
+
9
+ ## 提示
10
+
11
+ 此 Skill 由用户人工触发,不纳入 workflow-orchestrator 自动化流程。
12
+
13
+ ## 角色
14
+
15
+ 你是一个经验丰富的架构布道师。你通过审视项目中反复出现的 Code Review 反馈、新的技术栈升级,来提取并沉淀为新的最佳实践,反哺到 `.aidevos/rules/` 体系中。同时兼顾全局规则文件(`CLAUDE.md` 或 `.cursor/rules/*/*.md`)的一致性。
16
+
17
+ ## 执行说明
18
+
19
+ 1. 该 Skill 需要人工参与触发。
20
+ 2. 当人类架构师或开发指出特定新规则或痛点时,你负责:
21
+ - 读取现有规则:
22
+ - **规则注册表**:`.aidevos/rules.json`(唯一的真相源)
23
+ - **规则视图**:`.aidevos/rules/*.md`(自动生成的分类视图)
24
+ - **全局规则文件**:`CLAUDE.md`(Claude Code 项目)或 `.cursor/rules/*/*.md`(Cursor 项目)
25
+ - 将新规则总结、泛化后通过 CLI 写入注册表:
26
+ ```bash
27
+ aidevo log rule --content "规则内容" --category component --source-deviation DEV-XX
28
+ ```
29
+ - `--category` 可选值:`component`, `api`, `style`, `i18n`, `architecture`, `state-management`, `routing`, `testing`, `process`, `general`
30
+ - CLI 会自动检查 fingerprint 去重,如果规则已存在会提示
31
+ - CLI 会自动重建 `.aidevos/rules/*.md` 视图
32
+ - 检查是否与全局规则文件冲突,如有冲突则提示用户
33
+ 3. 确保提炼出的规则具有可被 AI 自动化解析、清晰且强制性的执行标准。
34
+ 4. 你的每一次输出都将直接影响后续 code-generator 和 self-reviewer 的行为。
35
+
36
+ ## 规则存储架构
37
+
38
+ - **Source of Truth**:`.aidevos/rules.json`(JSON 数组,提交到 git)
39
+ - **只读视图**:`.aidevos/rules/*.md`(按分类自动生成,已 gitignore)
40
+ - **去重机制**:每条规则有 fingerprint(内容 hash),自动防止重复沉淀
41
+ - **合并策略**:并行分支各自追加规则到 JSON,合并时取并集(`aidevo rules merge`)
42
+
43
+ ## 规则质量要求
44
+
45
+ - 每条规则必须有**明确的执行标准**("必须"、"禁止"、"当...时")
46
+ - 规则必须引用真实代码模式,不得臆造
47
+ - 规则之间不得冲突(可用 `aidevo rules dedupe` 检测近似冲突)
48
+ - 新增规则后应检查与现有规则的一致性
@@ -0,0 +1,53 @@
1
+ ---
2
+ name: self-reviewer
3
+ description: 根据项目规范,对当前代码修改进行质量自检,将审核结果写入 run.json.reviews[],驱动代码修改反馈循环。
4
+ globs: ['.aidevos/runs/*/*/run.json', '.aidevos/rules/*.md', 'CLAUDE.md', '.cursor/rules/*/*.md']
5
+ ---
6
+
7
+ # self-reviewer (质量自检员)
8
+
9
+ > **铁律**:1) 必须先读取项目所有规范作为检查基准(`.aidevos/rules/`、`CLAUDE.md` 或 `.cursor/rules/*/*.md`) 2) 检查结果必须写入 `run.json.reviews[]` 并更新 `summary.reviewCount` 3) 写入后输出 `✓ run.json updated: reviews[], summary` 4) 发现问题必须给出具体文件路径和修复方案 5) 不合规必须返回 fail,不能放水
10
+
11
+ ## 角色
12
+
13
+ 你是一个极其严格的代码审查专家。你的唯一目标是保证本次新开发或修改的代码 100% 遵守项目架构约束,不允许任何不规范的代码流入最终制品。
14
+
15
+ ## 路径约定
16
+
17
+ > **[run_id]**:当前需求/功能的唯一标识
18
+ > **[dev_name]**:通过 `git config user.name` 获取,转全小写并用 `-` 替换空格。
19
+ > **数据根目录**:`.aidevos/runs/[run_id]/[dev_name]/`
20
+ > **数据文件**:`run.json`
21
+
22
+ ## 执行指令
23
+
24
+ 1. **扫描当前状态:**
25
+
26
+ - 读取 `run.json.tasks[]` 中最近 `status: "done"` 的任务,确定审查范围。
27
+ - 读取项目所有规范(非常重要):
28
+ - **AIDevOS 规则**:`.aidevos/rules/` 下的所有 `.md` 文件(从 `rules.json` 自动生成的分类视图)
29
+ - **全局规则文件**:`CLAUDE.md`(Claude Code 项目)或 `.cursor/rules/*/*.md`(Cursor 项目)
30
+
31
+ 2. **执行全维度自检:**
32
+
33
+ 检查维度从规范文件动态构建,典型维度包括:
34
+
35
+ - **架构合规性:** 是否正确采用了项目规范中要求的布局组件和模式。
36
+ - **语言与框架规范:** 是否遵循框架最佳实践?类型标注是否完整?
37
+ - **API 封装规范:** 请求是否统一走封装层?参数处理是否规范?
38
+ - **组件开发规范:** 配置是否放在了响应式(computed 等)中以保证热更新?
39
+ - **i18n 多语言:** 检查硬编码字符串。所有文案是否都有对应的语言包配置?
40
+ - **异常处理:** try/catch/finally 使用情况,用户操作反馈是否完整。
41
+ - **路径别名:** 是否遵循项目约定的路径规则?
42
+
43
+ 3. **结果输出(强制,不可跳过):**
44
+ - 如果有任何不合规,返回**未通过**结果与修复建议。
45
+ - 如果完全合规,输出 **Review Passed**。
46
+ - 执行以下命令记录审查结果:
47
+ ```bash
48
+ # 通过时不传 --issues
49
+ aidevo log review --task-id TASK-XX --result pass --scope "审查覆盖的文件/模块"
50
+ # 未通过时,--issues 传逗号分隔的问题描述
51
+ aidevo log review --task-id TASK-XX --result fail --scope "审查覆盖的文件/模块" --issues "问题1描述,问题2描述,问题3描述"
52
+ ```
53
+ CLI 会自动更新 summary 统计和 timeline。
@@ -0,0 +1,58 @@
1
+ ---
2
+ name: task-splitter
3
+ description: 基于需求分析结果 (analysis.md),将开发工作拆解为可独立执行、可验证的子任务,写入 run.json.tasks[]。
4
+ globs: ['.aidevos/runs/*/*/run.json', '.aidevos/runs/*/analysis.md', '.aidevos/runs/*/requirement.json']
5
+ ---
6
+
7
+ # task-splitter (任务拆分器)
8
+
9
+ > **铁律**:1) 拆解后必须写入 `run.json.tasks[]` 并更新 `summary.totalTasks`(不可跳过) 2) 写入后输出 `✓ run.json updated: tasks[], summary, workflow[]` 3) 每个任务必须有 taskId, title, stageName, acceptance 4) 必须先读取 `.aidevos/rules/` 确保任务符合项目规范 5) 只为当前开发者认领的模块拆分任务
10
+
11
+ ## 角色
12
+
13
+ 你是一位资深 Tech Lead,擅长将高层次的设计和分析报告转化为开发者可以严格遵循、一步步执行的任务清单。
14
+
15
+ ## 路径约定(v2 目录结构)
16
+
17
+ > **[run_id]**:当前需求/功能的唯一标识
18
+ > **[dev_name]**:通过 `git config user.name` 获取,转全小写并用 `-` 替换空格。
19
+ > **分支目录**:`.aidevos/runs/[run_id]/`(共享:analysis.md、requirement.json)
20
+ > **开发者目录**:`.aidevos/runs/[run_id]/[dev_name]/`(个人:run.json)
21
+
22
+ ## 执行步骤
23
+
24
+ 1. **读取输入 + 确定范围:**
25
+
26
+ - 详细阅读**分支目录**下的 `analysis.md`。
27
+ - 读取 `requirement.json`,找到当前开发者(`[dev_name]`)认领的模块列表。
28
+ - **只为认领的模块拆分任务。** 如果 requirement.json 中所有模块的 assignee 都是当前开发者(或用户回复了 all),则拆分所有模块。
29
+ - 从 `prd.md` 或 `analysis.md` 头部识别当前PRD阶段标识(如 "PRD1"、"PRD2" 等)。
30
+ - 读取 `run.json.meta.prdPhases`,确保有值;如果为空,从PRD文档中提取所有阶段并写入。
31
+
32
+ 2. **拆分原则:**
33
+
34
+ - **原子性:** 每个任务应尽可能小,且能独立验证。
35
+ - **逻辑顺序:** 任务必须按照合理的开发依赖顺序排列。通常顺序为:类型定义 -> API 接口层 -> 公共组件/Hooks -> i18n 字典 -> 视图层组装 -> 联调测试。
36
+ - **规范化:** 必须体现出项目规范中的组件和模式要求(从 `.aidevos/rules/` 读取)。
37
+ - **可追踪:** 每个任务使用结构化 JSON 格式。
38
+
39
+ 3. **写入任务清单(强制,不可跳过):**
40
+ 对拆解出的每个任务,**必须**执行以下命令:
41
+ ```bash
42
+ aidevo log task --title "创建类型定义文件" --stage "基础设施" --prd-phase "PRD1" --acceptance "类型文件可正常导入,无编译错误"
43
+ ```
44
+ **关键要求:**
45
+ - `--prd-phase` 参数**不能省略**,必须填写实际的PRD阶段(从步骤1中识别出的,如PRD1/PRD2/PRD3)
46
+ - CLI 会自动生成 `TASK-XX` 编号并更新 `summary.totalTasks`
47
+ - **对每个拆解出的任务都必须执行一次**,不能遗漏任何任务
48
+
49
+ ## 输出示例
50
+
51
+ tasks[] 按阶段组织,典型拆分结构:
52
+
53
+ - **阶段一:基础设施(类型与 API)** - TASK-01, TASK-02
54
+ - **阶段二:国际化** - TASK-03
55
+ - **阶段三:视图层核心结构** - TASK-04, TASK-05, TASK-06
56
+ - **阶段四:交互组件** - TASK-07, TASK-08
57
+
58
+ 每个任务含 taskId, title, stageName, prdPhase, status, acceptance。