# 资产归档索引

本文件用于说明 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. 约定下一次复核时间和维护人。