القائمة
针对当前仓库执行指定改动范围的差异质检（默认当前工作区）。触发于用户要求审查本次改动、检查代码变更、review 代码、代码质检等场景。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
将用户提供的项目碎片信息整理为结构化中文 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。
| 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 问题