feat：update 3 4

2026-07-02 10:04:32 +08:00
parent 604e7e68d7
commit 2fd8fc1f66
224 changed files with 12369 additions and 9 deletions
@@ -0,0 +1,232 @@
+# 资产归档索引
+
+本文件用于说明 JeecgBoot 工单案例如何沉淀为团队可复用资产。具体可直接复制使用的资产已经生成在 [ai-dev-assets/](./ai-dev-assets/README.md)。
+
+如果要发给学员或项目团队，优先发：
+
+```text
+cases/jeecgboot-work-order/ai-dev-assets/
+```
+
+## 可沉淀资产
+
+| 资产类型 | 来源 | 归档价值 |
+| --- | --- | --- |
+| 项目源码定位图 | [source-map.md](./source-map.md) | 新人快速理解 JeecgBoot 类项目 |
+| Prompt 模板 | [prompts.md](./prompts.md)、[ai-dev-assets/prompts/jeecgboot](./ai-dev-assets/prompts/jeecgboot) | 复用读项目、拆需求、Review 的提问方式 |
+| 课堂工作表 | [worksheets.md](./worksheets.md)、[ai-dev-assets/templates/jeecgboot](./ai-dev-assets/templates/jeecgboot) | 标准化小组交付物 |
+| 验收清单 | [acceptance-checklist.md](./acceptance-checklist.md)、[ai-dev-assets/checklists/jeecgboot](./ai-dev-assets/checklists/jeecgboot) | 建立统一验收标准 |
+| 优秀小组案例 | 学员提交结果 | 建立正向样例 |
+| 问题案例 | [ai-dev-assets/examples/jeecgboot](./ai-dev-assets/examples/jeecgboot) | 建立反例和风险库 |
+| 讲师经验 | [instructor-guide.md](./instructor-guide.md) | 沉淀授课节奏和常见问题 |
+
+## 已生成的具体资产
+
+### 规则文件
+
+- [global.md](./ai-dev-assets/rules/global.md)
+- [frontend.md](./ai-dev-assets/rules/frontend.md)
+- [backend.md](./ai-dev-assets/rules/backend.md)
+- [security.md](./ai-dev-assets/rules/security.md)
+- [testing.md](./ai-dev-assets/rules/testing.md)
+- [delivery.md](./ai-dev-assets/rules/delivery.md)
+
+### Command 模板
+
+- [模块结构分析.command.md](./ai-dev-assets/commands/模块结构分析.command.md)
+- [工单需求拆解.command.md](./ai-dev-assets/commands/工单需求拆解.command.md)
+- [接口契约生成.command.md](./ai-dev-assets/commands/接口契约生成.command.md)
+- [代码生成Review.command.md](./ai-dev-assets/commands/代码生成Review.command.md)
+- [PR说明生成.command.md](./ai-dev-assets/commands/PR说明生成.command.md)
+
+### Skill 设计卡
+
+- [JeecgBoot工单模块开发审查.skill.md](./ai-dev-assets/skills/JeecgBoot工单模块开发审查.skill.md)
+- [generate-project-constraints/SKILL.md](./ai-dev-assets/skills/generate-project-constraints/SKILL.md)
+- [项目约束提取表.template.md](./ai-dev-assets/skills/generate-project-constraints/assets/项目约束提取表.template.md)
+- [项目约束验收清单.md](./ai-dev-assets/skills/generate-project-constraints/assets/项目约束验收清单.md)
+- [项目约束生成.prompt.md](./ai-dev-assets/skills/generate-project-constraints/assets/项目约束生成.prompt.md)
+- [design-complex-business-module/SKILL.md](./ai-dev-assets/skills/design-complex-business-module/SKILL.md)
+- [review-business-delivery/SKILL.md](./ai-dev-assets/skills/review-business-delivery/SKILL.md)
+- [track-review-fix-loop/SKILL.md](./ai-dev-assets/skills/track-review-fix-loop/SKILL.md)
+
+### 通用模板与检查表
+
+- [Plan任务模板.md](./ai-dev-assets/templates/Plan任务模板.md)
+- [AIReview报告模板.md](./ai-dev-assets/templates/AIReview报告模板.md)
+- [Browser验证报告模板.md](./ai-dev-assets/templates/Browser验证报告模板.md)
+- [任务成本与能力匹配表.md](./ai-dev-assets/checklists/任务成本与能力匹配表.md)
+- [Agent分工表.md](./ai-dev-assets/checklists/Agent分工表.md)
+- [CLI-MCP-Skill封装决策表.md](./ai-dev-assets/checklists/CLI-MCP-Skill封装决策表.md)
+
+### JeecgBoot 专用 Prompt
+
+- [RBAC权限矩阵生成.prompt.md](./ai-dev-assets/prompts/jeecgboot/RBAC权限矩阵生成.prompt.md)
+- [权限控制方案生成.prompt.md](./ai-dev-assets/prompts/jeecgboot/权限控制方案生成.prompt.md)
+- [状态流转设计.prompt.md](./ai-dev-assets/prompts/jeecgboot/状态流转设计.prompt.md)
+- [异常态补齐.prompt.md](./ai-dev-assets/prompts/jeecgboot/异常态补齐.prompt.md)
+- [看板指标设计.prompt.md](./ai-dev-assets/prompts/jeecgboot/看板指标设计.prompt.md)
+- [看板接口验收.prompt.md](./ai-dev-assets/prompts/jeecgboot/看板接口验收.prompt.md)
+- [阶段Review.prompt.md](./ai-dev-assets/prompts/jeecgboot/阶段Review.prompt.md)
+- [修复记录生成.prompt.md](./ai-dev-assets/prompts/jeecgboot/修复记录生成.prompt.md)
+
+### JeecgBoot 专用模板
+
+- [RBAC权限矩阵.template.md](./ai-dev-assets/templates/jeecgboot/RBAC权限矩阵.template.md)
+- [权限控制方案.template.md](./ai-dev-assets/templates/jeecgboot/权限控制方案.template.md)
+- [状态流转表.template.md](./ai-dev-assets/templates/jeecgboot/状态流转表.template.md)
+- [审计日志SOP.template.md](./ai-dev-assets/templates/jeecgboot/审计日志SOP.template.md)
+- [异常态清单.template.md](./ai-dev-assets/templates/jeecgboot/异常态清单.template.md)
+- [看板指标字典.template.md](./ai-dev-assets/templates/jeecgboot/看板指标字典.template.md)
+- [看板接口验收记录.template.md](./ai-dev-assets/templates/jeecgboot/看板接口验收记录.template.md)
+- [阶段Review报告.template.md](./ai-dev-assets/templates/jeecgboot/阶段Review报告.template.md)
+- [修复记录.template.md](./ai-dev-assets/templates/jeecgboot/修复记录.template.md)
+
+### JeecgBoot 专用检查清单
+
+- [权限上线前检查清单.md](./ai-dev-assets/checklists/jeecgboot/权限上线前检查清单.md)
+- [状态流转检查清单.md](./ai-dev-assets/checklists/jeecgboot/状态流转检查清单.md)
+- [审计日志检查清单.md](./ai-dev-assets/checklists/jeecgboot/审计日志检查清单.md)
+- [异常态检查清单.md](./ai-dev-assets/checklists/jeecgboot/异常态检查清单.md)
+- [看板指标口径检查清单.md](./ai-dev-assets/checklists/jeecgboot/看板指标口径检查清单.md)
+- [看板接口验收清单.md](./ai-dev-assets/checklists/jeecgboot/看板接口验收清单.md)
+- [Review修复闭环检查清单.md](./ai-dev-assets/checklists/jeecgboot/Review修复闭环检查清单.md)
+
+### 可教学反例
+
+- [好Command与坏Command对照.md](./ai-dev-assets/examples/好Command与坏Command对照.md)
+- [好Skill与坏Skill对照.md](./ai-dev-assets/examples/好Skill与坏Skill对照.md)
+- [好Plan与坏Plan对照.md](./ai-dev-assets/examples/好Plan与坏Plan对照.md)
+- [权限遗漏反例.md](./ai-dev-assets/examples/jeecgboot/权限遗漏反例.md)
+- [非法状态流转反例.md](./ai-dev-assets/examples/jeecgboot/非法状态流转反例.md)
+- [审计日志缺失反例.md](./ai-dev-assets/examples/jeecgboot/审计日志缺失反例.md)
+- [看板指标口径不清反例.md](./ai-dev-assets/examples/jeecgboot/看板指标口径不清反例.md)
+
+## 目录建议
+
+团队资产库可以按以下结构归档：
+
+```text
+ai-engineering-assets/
+├── rules/
+│   └── jeecgboot/
+├── prompts/
+│   └── jeecgboot-work-order/
+├── commands/
+│   └── jeecgboot/
+├── skills/
+│   └── jeecgboot-work-order-review/
+├── cases/
+│   └── jeecgboot-work-order/
+├── sop/
+│   └── ai-assisted-development/
+└── reviews/
+    └── examples/
+```
+
+## 规则资产
+
+适合沉淀为 rules 的内容：
+
+- 修改代码前必须先输出影响范围和验收方式。
+- JeecgBoot 后端修改必须遵守 `update-begin` / `update-end` 注释规则。
+- JeecgBoot 前端修改必须复用 `/@/` alias、`defHttp`、Pinia 和已有组件。
+- 权限相关任务必须覆盖页面级、按钮级、接口级和数据范围。
+- 状态流转任务必须先提供状态表和非法流转清单。
+- 审计任务必须记录 actor、action、targetId、oldValue、newValue、source。
+- 看板任务必须定义指标口径、维度、过滤条件和数据来源。
+
+## Prompt 资产
+
+适合归档的 Prompt：
+
+- 项目理解 Prompt。
+- 源码定位 Prompt。
+- 需求拆解 Prompt。
+- 接口契约 Prompt。
+- RBAC 权限矩阵 Prompt。
+- 权限落地检查 Prompt。
+- 状态机设计 Prompt。
+- 审计日志 Prompt。
+- 异常态 Prompt。
+- 看板指标 Prompt。
+- 修改计划 Prompt。
+- Review Prompt。
+
+归档时建议增加元数据：
+
+| 字段 | 示例 |
+| --- | --- |
+| 名称 | JeecgBoot 工单状态机设计 Prompt |
+| 适用项目 | JeecgBoot 3.9.x 类后台项目 |
+| 适用阶段 | 设计阶段 |
+| 输入材料 | 需求表、权限矩阵、源码依据 |
+| 输出格式 | 状态流转表、非法流转清单、测试点 |
+| 维护人 | 课程讲师或项目负责人 |
+| 更新时间 | 2026-07-01 |
+
+## Command 与 Skill 资产
+
+适合沉淀为 Command 的内容：
+
+- `/jeecgboot-source-map`：根据项目路径输出源码依据表。
+- `/work-order-rbac-review`：检查权限矩阵是否覆盖页面、按钮、接口和数据范围。
+- `/work-order-state-review`：检查状态流转表和非法流转清单。
+- `/work-order-delivery-review`：按验收清单审查小组交付物。
+
+适合沉淀为 Skill 的内容：
+
+- 跨项目约束生成 Skill。
+- 复杂业务模块设计 Skill。
+- 业务交付 Review Skill。
+- Review 修复闭环 Skill。
+- JeecgBoot 工单模块开发审查 Skill。
+- JeecgBoot 类后台权限落地检查 Skill。
+- JeecgBoot 代码生成后 Review Skill。
+
+Skill 应包含：
+
+- 触发场景。
+- 必需输入。
+- 执行步骤。
+- 输出格式。
+- 验收标准。
+- 禁止事项。
+
+## 案例库资产
+
+建议沉淀三类案例：
+
+| 案例类型 | 内容 | 用途 |
+| --- | --- | --- |
+| 优秀案例 | 证据充分、设计完整、验收清楚的小组成果 | 作为新人参考 |
+| 问题案例 | TRAE 幻觉、权限遗漏、状态遗漏、指标不可算 | 作为反例训练 |
+| 修复案例 | 从问题交付物到合格交付物的修改过程 | 训练 Review 和迭代 |
+
+每个案例至少保存：
+
+- 原始任务。
+- 输入上下文。
+- TRAE 输出。
+- 人工修订。
+- Review 记录。
+- 最终验收结论。
+
+## 维护机制
+
+| 机制 | 建议 |
+| --- | --- |
+| 资产负责人 | 每类资产指定一个维护人 |
+| 更新频率 | 每次培训后更新一次，项目大版本升级后复核一次 |
+| 废弃规则 | 与当前项目不再匹配的 Prompt 和规则必须标记废弃 |
+| 评审方式 | 由讲师、项目负责人和一名实际开发者共同评审 |
+| 版本记录 | 每次更新记录日期、原因和影响范围 |
+
+## 课后行动清单
+
+1. 从每组交付物中选 1-2 份优秀样例。
+2. 从 Review 中提取 3-5 个问题案例。
+3. 把高频 Prompt 收敛到团队 Prompt 库。
+4. 把稳定检查动作沉淀为 Command 或 Skill。
+5. 把项目约束沉淀到团队 rules。
+6. 约定下一次复核时间和维护人。