← ClaudeAtlas

api-full-chain-reviewlisted

扫描项目全部 Controller API,逐一组合请求方式与完整路径,并追踪前端页面、角色权限与数据范围、Service/Mapper/SQL、缓存、RPC、MQ和响应,最终生成逐项标注代码行号的 Excel 全链路核查工作簿。用户要求全量接口审计、Controller 接口安全/越权/敏感数据/异常数据/性能/事务核查,或审查包含学生、教师、辅导员、学院教务员、管理员、公共展示角色的项目时使用。不要用于仅审查 Git diff/PR、单文件代码、架构或测试质量;除非��户明确要求修复,否则只报告、不改代码。
yxhpy/api-full-chain-review · ★ 0 · AI & Automation · score 63
Install: claude install-skill yxhpy/api-full-chain-review
# 接口全链路代码核查 ## 边界 - 审查全部 Controller 接口;禁止抽样。 - 一个“请求方式 + 完整路径”是一个 `api_item`,全部项目组成 `api_list`。 - 分开记录“应有角色/权限”和“当前实际角色/权限”,不按接口名或数据表猜测。 - 无法从代码、配置、数据库关系或测试确认的结论写“待确认”,不得默认通过。 - 默认只输出报告;只有用户明确要求修复时才改代码。 - 明确要求修复时,必须先执行 [代码修改门禁](references/audit-spec.md#代码修改门禁仅在明确要求修复时);新产生的需求代码必须严格符合当前仓库适用规约。 ## 执行 1. 读取仓库指令,确认后端、前端、网关和配置所在根目录;存在 `.codegraph/` 时先按仓库指令使用 CodeGraph,再用文本搜索补漏。 2. 查找全部 Controller、标准映射注解和自定义映射元注解。读取网关前缀、`ContextPath`、Controller 路径和方法路径;将多请求方式、多路径展开为独立 `api_item`。按“完整路径 + 请求方式”稳定排序并编号 `API-001` 起。 3. 搜索前端 API 定义、URL 常量、封装调用、路由、页面、组件、按钮和业务操作。未找到时,只能标为“外部系统调用”“后端内部调用”“疑似废弃接口”或“待确认”,并给出证据。 4. 对每项追踪 `Controller → Service → Mapper/Repository → SQL`,同时列出响应转换、数据库表及操作、缓存、RPC、MQ、文件和其他外部调用。检查共享方法的全部调用方。 5. 从登录/权限注解、拦截器、权限配置、数据库建表/迁移/种子数据、用户-角色-菜单-按钮-接口关系和数据权限 SQL 反推当前实际权限与数据范围;再依据项目需求确定应有权限。缺少任一侧证据就标“待确认”。 6. 完整读取并执行 [核查规范](references/audit-spec.md) 的 59 个要点。每个 `api_item` 的每个要点单独一行,包括满足、不满足、不适用和待确认项。 7. 按 [Excel 工作簿规范](references/report-template.md) 生成一个 `.xlsx`,优先复制并填充 [工作簿模板](assets/api-full-chain-review-template.xlsx)。生成端只使用宿主已有的电子表格能力;没有可用的 `.xlsx` 写入和验证能力时报告阻塞,不得用 Markdown、CSV 或伪造扩展名替代。成品必须是无宏、无外部链接、无加载项、无自定义字体的标准 OOXML,接收方无需安装 Python、Node.js 或本 Skill。 8. 工作簿固定包含 `接口清单`、`逐项核查`、`接口汇总`、`总体统计` 四个工作表。代码结论必须填写仓库相对路径和准确行号,如 `src/main/java/.../StudentController.java:88`;多处证据在单元格内换行。问题描述必须再次点明关键代码行号。非代码证据可补充权限配置、数据库关系、SQL、命令及实际测试结果,但不得声称运行过未执行的检查。 9. 在 `总体统计` 写入当前 Git commit SHA 或版本标签,避免代码变化后行号失去上下文。无法定位代码时不得编造行号,只能标“待确认”或“不适用”并说明缺失内容。 10. 交付前按 [输出风险](reports/output-risk-pro