用途
本技能用于对 LoongCollector 项目的代码变更进行安全导向、架构一致性优先的深度代码评审。其核心目标是发现真实缺陷、行为回归和风险点,而不是给出泛泛建议。技能定位为“高级代码审查助手”,适用于 PR 评审与分支评审两种场景。
主要能力
- 增量评审:通过 reviewed_commits.json、patch-id 映射、hunk 指纹匹配等机制,只评审未覆盖的新变更,并在 rebase/force-push 时按置信度决定增量、局部补审或全量回退。
- 评论状态双维跟踪:区分流程状态(status_flow:open/resolved/wont-fix/deferred)与技术状态(status_tech:fixed/not-fixed/false-positive/partially-fixed),并支持人工手动订正与终态跳过规则。
- 快照机制:生成 snapshot/round-<n>/files/*、manifest.json、latest.json,用于下一轮增量决策辅助。
- 专项 sub-agent 并行检查:按责任矩阵划分逻辑与架构、并发与生命周期、安全稳定与性能、复用合规与文档一致性四类检查。
- 意图理解文档:产出含 Mermaid 图(至少 2 张)的 Code Review - Intent & Architecture Notes。
- 最终报告:按严重度排序的 Findings、Lifecycle Verdict、Fix Plan、Validation Plan,并支持发布到 PR。
使用方式
技能定义了严格的执行步骤:
- Preflight:执行
python3 --version、git rev-parse --is-inside-work-tree、gh auth status,任一失败须停止并按 references/failure-playbook.md 修复。 - Local Branch Sync:同步远程 PR headRefOid 或分支 HEAD SHA,并在 final-report.md 顶部记录 head SHA。
- Review Plan:在评审目录生成并维护 review-plan.md,按大项+子项拆分并勾选。
- Phase 1:初始化评审工作区,使用脚本 init_review_workspace.py、fetch_review_comments.py、update_comment_status.py、generate_comment_status_report.py、incremental_review_mapper.py、build_snapshot.py 等。
- Phase 2:读取 project-knowledge、architecture.md、codebase-map.md 及相关规范,构建全局认知。
- Phase 3:产出意图理解文档并落盘到 code-review 目录,含至少 2 张 Mermaid 图。
- Phase 4:并行启动 3-4 个 sub-agent 专项检查。
- Phase 5:输出 Final Report 并落盘,可选发布到 PR。
脚本失败时允许进入降级评审模式,但须记录 script-failures.md、切换 full 全量评审、在报告中增加 Script Failure Feedback 小节。
适用场景
- LoongCollector 项目的 PR 代码评审。
- LoongCollector 分支代码评审。
- 需要对增量变更做安全与架构一致性检查的场景。
- 需要跟踪历史评审意见修复情况的场景。
限制
- 技能明确要求结论必须基于实际读取到的代码与变更,不允许基于记忆或猜测。
- 仅评论真实变更范围内的问题,避免“顺手重构建议”淹没核心缺陷。
- 平台发布必须等待用户显式确认后才能执行。
- 依赖 python3、git、gh 等工具,任一 Preflight 命令失败须停止评审。
- 关于收费、价格、平台支持范围等具体信息,资料中暂未提供。