메뉴
针对当前仓库执行指定改动范围的差异质检（默认当前工作区）。触发于用户要求审查本次改动、检查代码变更、review 代码、代码质检等场景。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
| name | commit-quality-reviewer |
| description | 针对当前仓库执行指定改动范围的差异质检（默认当前工作区）。触发于用户要求审查本次改动、检查代码变更、review 代码、代码质检等场景。 |
用于对 用户指定范围 的改动做质量审查（默认 working tree）。
该 skill 只审查 diff 覆盖内容，不对未变更代码做泛化点评。
所有审查结论必须优先回答以下 3 个问题：
base_commit：
HEAD~1（当前版本对比上次提交）abc1234）compare_scope：
working_tree_only：仅审查未提交改动（默认）last_commit_only：仅审查 HEAD~1..HEADlast_commit_plus_working_tree：审查 HEAD~1..HEAD + 未提交改动whitelist：读取 .trae/skills/commit-quality-reviewer/docs/whitelist.md若用户要求“某次 commit 对比”，但未给 commit id，必须先追问并等待确认。
若用户仅说“本次改动/当前改动”且未明确范围，默认使用 working_tree_only。
compare_scope 对应的 diff 范围进行检查WAIVED，不计入阻塞结论以下为跨项目通用标准，与项目定制清单并行生效；若同一问题同时命中，按更高严重级别处理。
except/catch、错误被静默忽略compare_scope；若语义不清，先向用户确认范围，不得猜测。HEAD~1；若用户给 commit id，则使用用户给定值。.trae/skills/commit-quality-reviewer/docs/whitelist.md。WAIVED。CRITICAL/HIGH，再看 MEDIUM/LOW。last_commit_only（即 base_commit = HEAD~1）时，任务结束后必须附带如下建议：
commit-update-writer，为本次改动生成并追加更新文档到 docs/CHANGELOG.md。commit-quality-reviewer 中自动触发或代执行 commit-update-writer。在“通用代码审查基线”之外，额外检查以下项目特有风险。
API Key、数据库 URI、Lark 凭据、token 被硬编码或打印到日志user_id/fr_id 相关查询未做 ownership 校验即读写KeyboardInterrupt/业务异常处理不一致publish.yml 约定不一致FineGrainedFeedDimension、状态字段、prompt 环境变量命名漂移print/pprint、注释掉的旧逻辑、一次性调试分支.trae/skills/commit-quality-reviewer/docs/whitelist.mdprint 调试输出先给 Findings，再给 Summary。按严重级别从高到低排序。
## Core Check
- Reasonableness: PASS | WARN | FAIL
- New Issues Introduced: NO | YES
- Dependency Impact: SAFE | RISKY | BROKEN
## Findings
- [CRITICAL] <问题标题>
- File: <path>
- Evidence: <触发代码或行为>
- Risk: <具体风险>
- Fix: <可执行修复建议>
- Status: OPEN | WAIVED
## Summary
| Severity | Count(Open) | Count(Waived) |
| -------- | ----------: | ------------: |
| CRITICAL | 0 | 0 |
| HIGH | 1 | 0 |
| MEDIUM | 2 | 1 |
| LOW | 1 | 0 |
Decision: BLOCK | WARN | PASS
Base Commit: <base_commit>
Compared Scope: <working_tree_only | last_commit_only | last_commit_plus_working_tree>
Compared Range: <scope对应的真实范围>
BLOCK：存在任意 CRITICAL（且非 WAIVED）WARN：无 CRITICAL，但存在 HIGH（且非 WAIVED）PASS：无 CRITICAL/HIGH 的 OPEN 问题将用户提供的项目碎片信息整理为结构化中文 Markdown 文档并落盘到 docs。触发于用户提供零散片段并要求成文时；完成后必须调用 doc-optimizer。
对既有 Markdown 文档做结构化增强与可读性优化，保持原意与作者语气不变。触发于用户要求“润色 / 优化 / 重写文档但不改含义”时。
基于用户指定的改动范围（默认当前工作区）分析上下游依赖并产出改动说明，按时间顺序增量写入 docs/CHANGELOG.md 最上方。用户要求“生成本次改动文档/更新记录/changelog”时触发。
将 service 层方法按项目既有规范包装为 Robyn router 并暴露 HTTP API。用户提出“给 service 包一层 router”“暴露 http 接口”“按 user router 风格补接口”时必须触发；适用于 user、figure_and_relation、fine_grained_feed、knowledge 等模块。
基于 Graph 当前代码实现生成或重写说明文档。用户要求“给某个 Graph 写/重写 README、按既有风格成文、强调工作流与实现细节”时触发。
session 收尾自动提炼经验并路由到 skill/rule/agent。触发条件：session 收尾、用户明确纠偏、稳定实践/重复错误/harness 资产缺口暴露。关键字：session 收尾、纠偏、经验落盘、知识沉淀、skill 更新、rule 更新、agent 更新、ESLint 规则新增。文件类型：.trae/skills/**、.trae/rules/**、.trae/agents/**、AGENTS.md、.eslintrc.*。使用场景：每次 session 结束前判断是否有长期可复用知识，落盘到最合适的资产或输出 No-op。