| name | ccdawn-project-review |
| description | Use when CCDawn workflow needs a Chinese-first review of an entire repository, codebase, architecture, technical debt, test coverage, risk modules, maintainability, onboarding state, or project health before planning, refactoring, takeover, or prioritization. |
| license | MIT |
CCDawn Project Review
目标
对整仓或明确子系统做只读、证据化审查，找出最影响完成率、误改率和用户价值的问题。PR/diff 使用 ccdawn-pr-review，具体 bug 使用 ccdawn-bug-review。
BRT interface
- Context Boundary: 审查范围、实际读取的入口/模块/测试/配置/git/运行证据和排除范围。
- Output Contract: 项目健康结论、风险排序 findings、可连续执行的修复顺序和 Route Out。
- Allowed Action: 默认只读；不编辑文件、移动分支或修改 index。用户要求修复时由 BRT 建立执行契约。
- Success Evidence: finding 绑定文件/命令/运行证据、影响、最小动作和验证条件。
- Stop Condition: 范围不明、对象变成 PR/具体 bug、关键证据缺失、需要写入或高风险决策。
- Route Out:
ccdawn-simplification-audit、ccdawn-planning、ccdawn-bug-review、ccdawn-performance-engineering、ccdawn-pr-review、ccdawn-brt 或 BLOCKED。
统一调用契约
- 只处理 BRT interface 范围；不匹配时回
ccdawn-brt 或更具体 owner，复合任务不吞其他 owner。
- 用户可见内容默认中文；保留技术字面量；只报结论、证据、风险和产出；Route Out 仅以 BRT interface 为准，末行写
下一步建议: <一个具体动作>。
深度与证据
QUICK：目录、README、配置、测试入口和近期 git 信号。STANDARD：默认；增加关键链路、依赖、CI、测试质量和边界。DEEP：接手、重构或高风险发布前；增加热点历史、状态/数据/权限/迁移风险。
不要为了全面扫描全仓。先确认事实源和高信号入口，再沿用户目标钻取 owning modules；证据足以回答审查目标时停止。按需检查架构边界、修改热点、真实行为测试、配置/数据/权限、发布回滚和接续成本，不为未命中的通用清单继续扩读。
Findings
严重度：P0 数据/安全/核心不可用；P1 高风险缺陷或关键契约/测试缺口；P2 明显增加误改和维护成本；P3 非阻塞改进。
每条必须包含：位置或命令证据、具体观察、影响、最小有效动作、验证条件。不得把“项目复杂”“测试不足”“TODO 很多”直接当 finding；孤立实现 bug 不升级为项目 finding，除非证据表明它代表重复模式、架构边界或系统性风险。
Telemetry Gap 与已确认问题分开；WATCHLIST 必须写明升级、降级或关闭所需的日志、指标、测试或时间窗口。
执行顺序
多个 finding 按依赖、用户价值、误改风险和验证成本排序，而不是只推荐一个：
SAFE_DIRECT：已有修复许可时依次执行并验证，不逐项询问。PLAN_THEN_EXECUTE：存在设计分叉时先规划，再回到执行。DEFERRED：只记录触发条件。BLOCKED：停止并问一个不可约问题。
只有顺序会改变产品取舍、范围或高风险动作时才让用户选择。只读审查请求本轮停在报告；用户说“继续/开始修复/按顺序修”时从第一个非 Deferred/Blocked 项连续推进。
输出
项目审查: HEALTHY / WATCHLIST / NEEDS_ATTENTION / HIGH_RISK / BLOCKED
范围与关键证据: ...
Findings:
- P0/P1/P2/P3 [位置] 问题；影响；最小动作；验证条件
执行顺序（仅多个后续动作时）:
1. <动作> [SAFE_DIRECT/PLAN_THEN_EXECUTE/DEFERRED/BLOCKED]
证据缺口与剩余风险: ...
下一步建议: <一个具体动作>
没有 finding 时明确说明未发现结构性问题，并用一句话说明最重要的未覆盖边界。不默认生成项目地图、矩阵、ledger、完整扫描清单或专项路由清单。
