api-full-chain-reviewlisted
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