smart
10 KiB
10 KiB
资产归档索引
本文件用于说明 JeecgBoot 工单案例如何沉淀为团队可复用资产。具体可直接复制使用的资产已经生成在 ai-dev-assets/。
如果要发给学员或项目团队，优先发：
cases/jeecgboot-work-order/ai-dev-assets/
可沉淀资产
| 资产类型 | 来源 | 归档价值 |
|---|---|---|
| 项目源码定位图 | source-map.md | 新人快速理解 JeecgBoot 类项目 |
| Prompt 模板 | prompts.md、ai-dev-assets/prompts/jeecgboot | 复用读项目、拆需求、Review 的提问方式 |
| 课堂工作表 | worksheets.md、ai-dev-assets/templates/jeecgboot | 标准化小组交付物 |
| 验收清单 | acceptance-checklist.md、ai-dev-assets/checklists/jeecgboot | 建立统一验收标准 |
| 优秀小组案例 | 学员提交结果 | 建立正向样例 |
| 问题案例 | ai-dev-assets/examples/jeecgboot | 建立反例和风险库 |
| 讲师经验 | instructor-guide.md | 沉淀授课节奏和常见问题 |
已生成的具体资产
规则文件
Command 模板
Skill 设计卡
- JeecgBoot工单模块开发审查.skill.md
- generate-project-constraints/SKILL.md
- 项目约束提取表.template.md
- 项目约束验收清单.md
- 项目约束生成.prompt.md
- design-complex-business-module/SKILL.md
- review-business-delivery/SKILL.md
- track-review-fix-loop/SKILL.md
通用模板与检查表
JeecgBoot 专用 Prompt
- RBAC权限矩阵生成.prompt.md
- 权限控制方案生成.prompt.md
- 状态流转设计.prompt.md
- 异常态补齐.prompt.md
- 看板指标设计.prompt.md
- 看板接口验收.prompt.md
- 阶段Review.prompt.md
- 修复记录生成.prompt.md
JeecgBoot 专用模板
- RBAC权限矩阵.template.md
- 权限控制方案.template.md
- 状态流转表.template.md
- 审计日志SOP.template.md
- 异常态清单.template.md
- 看板指标字典.template.md
- 看板接口验收记录.template.md
- 阶段Review报告.template.md
- 修复记录.template.md
JeecgBoot 专用检查清单
可教学反例
- 好Command与坏Command对照.md
- 好Skill与坏Skill对照.md
- 好Plan与坏Plan对照.md
- 权限遗漏反例.md
- 非法状态流转反例.md
- 审计日志缺失反例.md
- 看板指标口径不清反例.md
目录建议
团队资产库可以按以下结构归档：
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-2 份优秀样例。
- 从 Review 中提取 3-5 个问题案例。
- 把高频 Prompt 收敛到团队 Prompt 库。
- 把稳定检查动作沉淀为 Command 或 Skill。
- 把项目约束沉淀到团队 rules。
- 约定下一次复核时间和维护人。