smart
67837df8d0
- 新增全套考试卷、评估卷、参考答案与考试培训包模板 - 修正slidev培训课件：调整模块标题、链路图缩放，替换工单示例为通用业务对象 - 修正课堂红线表述为证据红线，将小组作业调整为个人作业要求 - 新增权限、状态流转、审计日志、看板指标四类可复用业务规则块 - 整理AI工程技能交付包，迁移旧资产至客户专属交付包并统一术语 - 新增考试输出模板与TRAE使用记录文档
281 lines
10 KiB
Markdown
281 lines
10 KiB
Markdown
# 模块 7：阶段代码审查与修复
|
|
|
|
<div class="mt-6 text-sm">
|
|
|
|
工单模块改动涉及权限、状态、审计、异常和看板，必须做阶段 Review。
|
|
|
|
</div>
|
|
|
|
<div class="grid grid-cols-2 gap-4 mt-8 text-sm">
|
|
<div class="p-3 rounded-xl bg-blue-500/10 border border-blue-500/30">权限是否闭环</div>
|
|
<div class="p-3 rounded-xl bg-blue-500/10 border border-blue-500/30">状态流转是否完整</div>
|
|
<div class="p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30">审计日志是否可查</div>
|
|
<div class="p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30">异常态是否覆盖</div>
|
|
<div class="p-3 rounded-xl bg-amber-500/10 border border-amber-500/30">看板口径是否清楚</div>
|
|
<div class="p-3 rounded-xl bg-amber-500/10 border border-amber-500/30">测试是否覆盖关键路径</div>
|
|
</div>
|
|
|
|
<!--
|
|
Review 的重点不是格式，也不是变量名。
|
|
第四天 Review 要检查业务闭环：权限、状态、审计、异常、看板和测试。
|
|
-->
|
|
|
|
---
|
|
|
|
# AI Review 输入
|
|
|
|
<div class="mt-5 text-sm">
|
|
|
|
| 输入材料 | 用途 |
|
|
|---|---|
|
|
| 当天 diff | 看实际修改 |
|
|
| RBAC 权限矩阵 | 判断权限是否正确 |
|
|
| 状态流转表 | 判断合法和非法路径 |
|
|
| 审计日志 SOP | 判断是否可追溯 |
|
|
| 异常态清单 | 判断防御性逻辑 |
|
|
| 看板指标字典 | 判断统计口径 |
|
|
| 测试结果 | 判断是否可验收 |
|
|
|
|
</div>
|
|
|
|
<!--
|
|
AI Review 不能只给 diff。
|
|
如果不给业务产物，AI 很难判断代码是否符合业务规则。
|
|
-->
|
|
|
|
---
|
|
|
|
# 复杂业务控制面的三个 Skill
|
|
|
|
<div class="mt-5 text-xs">
|
|
|
|
| Skill | 什么时候用 | 输入材料 | 输出产物 |
|
|
|---|---|---|---|
|
|
| design-complex-business-module | 开始写代码前 | 需求、项目规则、现有角色/API/表结构 | RBAC、权限方案、状态表、审计 SOP、异常清单、指标字典 |
|
|
| review-business-delivery | 阶段 Review 时 | diff、业务产物、测试结果、验收记录 | 问题清单、证据缺口、待确认项 |
|
|
| track-review-fix-loop | 修 Review 后 | Review 报告、修改文件、验证证据 | 修复记录、未闭环事项、资产更新建议 |
|
|
|
|
</div>
|
|
|
|
<div class="mt-4 p-3 rounded-xl bg-blue-500/10 border border-blue-500/30 text-sm">
|
|
Skill 负责流程和质量门禁；rule 负责长期约束；template/checklist 负责稳定输出。
|
|
</div>
|
|
|
|
<!--
|
|
这里把 Skill 放在阶段 Review 前后承接处。
|
|
前三天讲过 Skill 的概念，第四天要让学员看到具体怎么用。
|
|
design-complex-business-module 用在开工前，review-business-delivery 用在阶段审查，track-review-fix-loop 用在修复闭环。
|
|
这三个 Skill 串起来，正好覆盖复杂业务从设计、审查到沉淀资产的全过程。
|
|
-->
|
|
|
|
---
|
|
|
|
# design-complex-business-module 怎么用
|
|
|
|
<div class="mt-5 text-xs">
|
|
|
|
```md
|
|
请使用 design-complex-business-module，基于 JeecgBoot 工单模块设计复杂业务控制面。
|
|
|
|
输入材料：
|
|
1. 需求范围：工单权限、状态流转、审计、异常态、看板。
|
|
2. 项目规则：security-permission、state-audit、testing、delivery。
|
|
3. 现有证据：角色、菜单权限、接口、数据表、相似模块。
|
|
|
|
输出必须包含：
|
|
RBAC 权限矩阵、权限控制方案、状态流转表、非法流转清单、
|
|
审计日志 SOP、异常态清单、看板指标字典、看板接口验收记录。
|
|
|
|
要求：
|
|
没有源码或配置证据的内容标记为“建议”或“待确认”。
|
|
```
|
|
|
|
</div>
|
|
|
|
<!--
|
|
这个 Skill 的重点是“先设计控制面，再设计代码”。
|
|
它不是让 AI 直接写实现，而是先把权限、状态、审计、异常态、看板和验收资产凑齐。
|
|
课堂里可以让学员用它生成第一版产物，再由主讲人结合已读源码补业务确认。
|
|
-->
|
|
|
|
---
|
|
|
|
# 阶段 Review 报告
|
|
|
|
<div class="mt-5 text-xs">
|
|
|
|
| 等级 | 模块 | 问题 | 风险 | 修复建议 | 验收 |
|
|
|---|---|---|---|---|---|
|
|
| P1 | 权限 | 删除接口只隐藏按钮，后端缺少校验 | 可绕过前端删除工单 | 补后端权限校验 | 无权限请求返回 403 |
|
|
| P1 | 状态 | closed 工单仍可重新处理 | 关闭状态失效 | 禁止 closed -> processing | 接口返回非法状态 |
|
|
| P2 | 审计 | 指派未记录前后值 | 难以追踪责任 | 记录 old/new assignee | 详情页日志可查 |
|
|
| P2 | 看板 | 平均关闭周期口径不清 | 管理判断失真 | 明确 create_time 到 close_time | 指标字典更新 |
|
|
|
|
</div>
|
|
|
|
<!--
|
|
Review 输出必须结构化。
|
|
每个问题要有等级、模块、风险、修复建议和验收方式。
|
|
-->
|
|
|
|
---
|
|
|
|
# review-business-delivery 怎么用
|
|
|
|
<div class="mt-5 text-xs">
|
|
|
|
```md
|
|
请使用 review-business-delivery 对本次工单模块改动做阶段 Review。
|
|
|
|
输入材料：
|
|
- 当天 diff 或修改文件清单
|
|
- RBAC 权限矩阵和权限控制方案
|
|
- 状态流转表和非法流转清单
|
|
- 审计日志 SOP 和异常态清单
|
|
- 看板指标字典和接口验收记录
|
|
- 测试命令、接口响应、浏览器验证或手工验收记录
|
|
|
|
输出格式：
|
|
先列问题清单，按 P0/P1/P2/P3 排序；
|
|
每个问题必须有证据、风险、修复建议和验收方式；
|
|
缺少证据时单独列“证据缺口”，不要猜测。
|
|
```
|
|
|
|
</div>
|
|
|
|
<!--
|
|
Review Skill 的作用是防止 AI 只做代码风格点评。
|
|
第四天 Review 必须把业务产物和代码 diff 一起看，否则无法判断权限是否闭环、状态是否非法、审计是否可查、指标口径是否正确。
|
|
-->
|
|
|
|
---
|
|
|
|
# 修复记录
|
|
|
|
<div class="mt-5 text-xs">
|
|
|
|
| Review 编号 | 问题 | 是否成立 | 修改说明 | 验证结果 | 资产沉淀 |
|
|
|---|---|---|---|---|---|
|
|
| R01 | 删除接口缺少权限校验 | 是 | 增加后端权限校验 | 无权限请求被拒绝 | 权限检查清单 |
|
|
| R02 | closed 可重新处理 | 是 | 补非法流转校验 | 状态不变 | 状态流转检查清单 |
|
|
| R03 | 看板关闭周期口径不清 | 是 | 明确指标口径 | 指标说明已更新 | 看板口径清单 |
|
|
|
|
</div>
|
|
|
|
<!--
|
|
Review 不是结束。
|
|
每个问题都要判断是否成立、记录修改说明、验证结果和是否沉淀资产。
|
|
-->
|
|
|
|
---
|
|
|
|
# track-review-fix-loop 怎么用
|
|
|
|
<div class="mt-5 text-xs">
|
|
|
|
```md
|
|
请使用 track-review-fix-loop，把阶段 Review 问题转成修复闭环记录。
|
|
|
|
输入材料：
|
|
- 带编号的 Review 报告
|
|
- 修改文件或产物
|
|
- 测试输出、接口响应、浏览器截图或手工验收步骤
|
|
- 现有 rules、checklists、prompts、examples、skills 目录
|
|
|
|
每个问题状态只能是：
|
|
成立-已修复 / 成立-暂不修复 / 不成立 / 需确认 / 未闭环
|
|
|
|
输出必须包含：
|
|
修复记录、未闭环事项、资产更新建议。
|
|
资产类型从 rule、checklist、prompt、command、skill、example 中选择。
|
|
```
|
|
|
|
</div>
|
|
|
|
<!--
|
|
修复闭环 Skill 对应第四天最后的资产沉淀。
|
|
它要求每个问题不能只写“已修复”，必须有证据和状态。
|
|
如果问题反复出现，例如权限绕过、非法状态流转、审计缺失，就要判断是否沉淀为 rule、checklist、prompt、example 或新的 Skill。
|
|
-->
|
|
|
|
---
|
|
|
|
# 复杂业务模块资产
|
|
|
|
<div class="grid grid-cols-2 gap-3 mt-6 text-sm">
|
|
<div class="p-3 rounded-xl bg-blue-500/10 border border-blue-500/30">01 工单 RBAC 权限矩阵</div>
|
|
<div class="p-3 rounded-xl bg-blue-500/10 border border-blue-500/30">02 工单权限控制方案</div>
|
|
<div class="p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30">03 工单状态流转表</div>
|
|
<div class="p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30">04 非法流转清单</div>
|
|
<div class="p-3 rounded-xl bg-amber-500/10 border border-amber-500/30">05 工单审计日志 SOP</div>
|
|
<div class="p-3 rounded-xl bg-amber-500/10 border border-amber-500/30">06 异常态与防御性逻辑清单</div>
|
|
<div class="p-3 rounded-xl bg-purple-500/10 border border-purple-500/30">07 研发效能看板指标字典</div>
|
|
<div class="p-3 rounded-xl bg-purple-500/10 border border-purple-500/30">08 看板接口验收记录</div>
|
|
<div class="p-3 rounded-xl bg-red-500/10 border border-red-500/30">09 阶段 Review 报告</div>
|
|
<div class="p-3 rounded-xl bg-red-500/10 border border-red-500/30">10 修复记录</div>
|
|
</div>
|
|
|
|
<!--
|
|
第四天最终交付十个产物。
|
|
这些产物共同说明：工单模块不只是能运行，还具备权限、状态、审计、异常和指标的工程闭环。
|
|
-->
|
|
|
|
---
|
|
|
|
# 复杂业务资产包目录
|
|
|
|
<div class="mt-5 text-xs">
|
|
|
|
```text
|
|
ai-dev-assets/
|
|
├── rules/
|
|
│ ├── security-permission.md
|
|
│ ├── state-audit.md
|
|
│ ├── testing.md
|
|
│ └── delivery.md
|
|
├── skills/
|
|
│ ├── design-complex-business-module/
|
|
│ ├── review-business-delivery/
|
|
│ └── track-review-fix-loop/
|
|
├── templates/jeecgboot/
|
|
├── checklists/jeecgboot/
|
|
├── prompts/jeecgboot/
|
|
└── examples/jeecgboot/
|
|
```
|
|
|
|
</div>
|
|
|
|
<div class="mt-4 p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30 text-sm">
|
|
交付给团队的不是聊天记录，而是可安装、可复用、可审查的工程资产包。
|
|
</div>
|
|
|
|
<!--
|
|
这一页把第四天的 rule 和 Skill 落到目录结构。
|
|
rules 是长期约束，skills 是可触发流程，templates/checklists/prompts/examples 是 Skill 会调用的材料。
|
|
这样学员能把课堂产物带回团队，而不是停留在一次性演示。
|
|
-->
|
|
|
|
---
|
|
layout: center
|
|
class: text-center
|
|
---
|
|
|
|
# 复杂业务模块的控制面
|
|
|
|
<div class="mt-8 text-lg">
|
|
让工单模块从“能跑通”升级到“可控制、可审计、可验证、可 Review”。
|
|
</div>
|
|
|
|
<div class="grid grid-cols-5 gap-3 mt-8 text-sm">
|
|
<div class="p-3 rounded-xl bg-blue-500/10 border border-blue-500/30">权限矩阵</div>
|
|
<div class="p-3 rounded-xl bg-emerald-500/10 border border-emerald-500/30">状态机</div>
|
|
<div class="p-3 rounded-xl bg-amber-500/10 border border-amber-500/30">审计 SOP</div>
|
|
<div class="p-3 rounded-xl bg-purple-500/10 border border-purple-500/30">异常清单</div>
|
|
<div class="p-3 rounded-xl bg-red-500/10 border border-red-500/30">Review 闭环</div>
|
|
</div>
|
|
|
|
<!--
|
|
第四天的核心不是让 AI 多写代码。
|
|
核心是让 AI 按规则、证据和验收标准协作，把复杂业务的风险变成可检查、可修复、可沉淀的工程资产。
|
|
-->
|