smart
233 lines
10 KiB
Markdown
233 lines
10 KiB
Markdown
# 资产归档索引
|
||
|
||
本文件用于说明 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. 约定下一次复核时间和维护人。
|