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,12 @@
+# Agent 分工表
+
+| Agent | 输入 | 动作 | 输出 | 验收 | 边界 |
+| --- | --- | --- | --- | --- | --- |
+| 需求拆解 Agent | 原始需求 | 拆用户故事、边界、异常 | 需求拆解文档 | 有验收标准 | 不直接写代码 |
+| 代码理解 Agent | 项目路径 | 找入口、链路、依据 | 源码依据表 | 能指向文件 | 不做业务决策 |
+| 规则审查 Agent | rules + 任务 | 判断规则命中 | 规则命中表 | 能解释触发原因 | 不改规则 |
+| 代码生成审查 Agent | 生成代码、字段表、rules | 查字段、查询、字典、异常态 | 代码生成 Review 清单 | 能指向文件和问题 | 不直接合入 |
+| 测试建议 Agent | 需求、diff | 生成测试点 | 测试点清单 | 覆盖正常/异常/权限/状态 | 不替代人工验收 |
+| Review Agent | diff、rules、测试结果 | 输出问题等级和建议 | Review 报告 | 问题可定位 | 不替代负责人判断 |
+| 文档整理 Agent | 课堂产出 | 归档资产 | 资产库条目 | 命名清楚 | 不编造产出 |
+
@@ -0,0 +1,11 @@
+# CLI / MCP / Skill 封装决策表
+
+| 需求 | 推荐封装 | 理由 | 验收 |
+| --- | --- | --- | --- |
+| 生成 PR 说明 | Command | 固定格式、低风险 | PR 模板字段完整 |
+| 检查代码生成结果 | Command | 输入固定、输出固定 | Review 清单完整 |
+| JeecgBoot 工单模块开发审查 | Skill | 多步骤、多文件、多规则 | 输出风险表和依据 |
+| 调用浏览器检查页面 | MCP / Browser | 需要真实页面状态 | 有截图或操作证据 |
+| 批量扫描源码指标 | CLI | 可脚本化、重复执行 | 命令输出稳定 |
+| 跨系统取数据 | MCP | 需要外部工具或系统 | 有鉴权和审计 |
+
@@ -0,0 +1,12 @@
+# Review 修复闭环检查清单
+
+| 检查项 | 通过标准 | 结果 |
+| --- | --- | --- |
+| 问题编号 | 每个 Review 问题有编号 |  |
+| 成立判断 | 每个问题说明是否成立 |  |
+| 修改说明 | 成立问题说明修改文件和内容 |  |
+| 验证结果 | 每个修复有验证证据 |  |
+| 未修复说明 | 暂不修复的问题有原因和后续计划 |  |
+| 资产沉淀 | 有复用价值的问题已进入检查清单或反例库 |  |
+| 回归检查 | 修复后重新检查相关权限/状态/审计/看板 |  |
+
@@ -0,0 +1,13 @@
+# 审计日志检查清单
+
+| 检查项 | 通过标准 | 结果 |
+| --- | --- | --- |
+| 创建记录 | 创建工单后能查询审计记录 |  |
+| 字段变更 | 编辑关键字段记录 oldValue/newValue |  |
+| 指派记录 | 指派负责人记录原负责人和新负责人 |  |
+| 状态记录 | 状态流转记录原状态和新状态 |  |
+| 操作人 | actor_id 和 actor_name 可追溯 |  |
+| 来源 | source 或 request_id 可追溯 |  |
+| 脱敏 | 敏感字段不明文进入审计 |  |
+| 失败处理 | 操作失败不写成功审计 |  |
+
@@ -0,0 +1,13 @@
+# 异常态检查清单
+
+| 异常态 | 必须验证 | 结果 |
+| --- | --- | --- |
+| 空列表 | 页面显示空状态，不报错 |  |
+| 详情不存在 | 提示工单不存在，页面不崩溃 |  |
+| 权限不足 | 前端提示或隐藏，后端拒绝 |  |
+| 非法状态 | 返回非法流转，状态不变 |  |
+| 重复提交 | 只成功一次，只写一条有效审计 |  |
+| 参数缺失 | 返回参数错误，业务数据不变 |  |
+| 并发修改 | 拒绝覆盖或提示刷新 |  |
+| 看板无数据 | 图表显示空态，不显示假数据 |  |
+
@@ -0,0 +1,12 @@
+# 权限上线前检查清单
+
+| 检查项 | 通过标准 | 结果 |
+| --- | --- | --- |
+| 菜单权限 | 工单菜单只对授权角色可见 |  |
+| 按钮权限 | 新增、编辑、删除、指派、状态按钮按权限显示 |  |
+| 接口权限 | 无权限账号直接请求敏感接口失败 |  |
+| 数据权限 | 普通用户只能看到授权范围内工单 |  |
+| 权限字符 | 前端按钮、菜单配置、后端接口命名一致 |  |
+| 审计 | 权限敏感操作成功后有审计记录 |  |
+| 反例验证 | 无权限账号不能绕过前端执行删除/指派 |  |
+
@@ -0,0 +1,12 @@
+# 状态流转检查清单
+
+| 检查项 | 通过标准 | 结果 |
+| --- | --- | --- |
+| 状态枚举 | 所有状态有统一枚举或字典 |  |
+| 合法流转 | 状态流转表中的合法路径可执行 |  |
+| 非法流转 | 非法路径被拒绝且状态不变 |  |
+| 角色限制 | 不同角色只能执行被授权动作 |  |
+| 前置条件 | 驳回原因、关闭条件、负责人等校验完整 |  |
+| 审计日志 | 每次成功流转写审计 |  |
+| 重复提交 | 重复点击不会产生重复有效流转 |  |
+
@@ -0,0 +1,13 @@
+# 看板指标口径检查清单
+
+| 检查项 | 通过标准 | 结果 |
+| --- | --- | --- |
+| 指标含义 | 每个指标有业务解释 |  |
+| 计算口径 | 每个指标有公式或筛选条件 |  |
+| 时间范围 | 明确按创建时间、关闭时间还是更新时间统计 |  |
+| 数据范围 | 不同角色的数据范围清楚 |  |
+| 空数据 | 空数据展示为 0 或空态，不误导 |  |
+| 分组一致性 | 分组总和能和总数对齐 |  |
+| 权限 | 无看板权限不能访问接口 |  |
+| 验收证据 | 至少有一组样例数据手工校验 |  |
+
@@ -0,0 +1,12 @@
+# 看板接口验收清单
+
+| 验收项 | 请求条件 | 通过标准 | 结果 |
+| --- | --- | --- | --- |
+| 默认查询 | 管理员默认条件 | 返回完整指标 |  |
+| 时间过滤 | 指定 start/end | 只统计时间范围内数据 |  |
+| 类型过滤 | 指定工单类型 | 只统计对应类型 |  |
+| 空数据 | 无匹配条件 | 返回 0 或空集合 |  |
+| 无权限 | 未授权账号 | 返回 403 或业务拒绝 |  |
+| 数据范围 | 普通角色 | 只返回授权范围 |  |
+| 指标一致性 | 固定样例数据 | 与手工计算一致 |  |
+
@@ -0,0 +1,11 @@
+# 任务成本与能力匹配表
+
+| 任务 | 风险 | 上下文需求 | 推荐能力 | 验收方式 |
+| --- | --- | --- | --- | --- |
+| 拆解工单需求 | 中 | 需求说明 + 项目规则 | Agent 分析 | 有用户故事和验收标准 |
+| 生成接口契约 | 中 | 需求 + 字段 + 权限 | Command | 接口表完整 |
+| 审查代码生成结果 | 中 | 生成代码 + rules | Command / Skill | 输出代码生成 Review 清单 |
+| 修改工单状态流转 | 高 | 相关文件 + rules + 测试 | Plan 后执行 | 状态机验证 + Review |
+| 生成 PR 说明 | 低 | diff + 测试结果 | Command | PR 模板字段完整 |
+| 修复 CI 失败 | 中 | CI 日志 + diff + rules | Agent 分析 | 失败原因和修复方案清楚 |
+