Comment Quality Review — PR ＜n＞

Comment Quality Review — PR #【免费下载链接】ArchonThe first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.项目地址: https://gitcode.com/GitHub_Trending/archon3/ArchonSummary1-2 sentences. Comment quality: good / minor-issues / significant-rot-risk.FindingsHIGH — inaccurate comments (dont match the code)file:line:Suggested fix:MEDIUM — comment rot risk(same format — references that will rot, restated-what-not-why, multi-paragraph fluff)LOW — style / consistency(same format)Comments that are actually valuableoptionally call out 1-2 cases where the new comments do a great job of capturing non-obvious WHY. Helps reinforce good patterns.Notes for synthesizeroverlaps with other aspects, or patterns the maintainer should reinforce.模板设计的几个要点 - **严重度分级**HIGH / MEDIUM / LOW与代码评审命令[maintainer-review-code-review.md](https://link.gitcode.com/i/91253189aa352c80627e58e604a9e61e) 的 CRITICAL/HIGH/MEDIUM/LOW 体系对齐但不相同——注释问题几乎不会构成 CRITICAL 级别的阻塞所以从 HIGH 起步 - **每条 HIGH 必须同时给出精确位置file:line、问题描述和修复建议update or remove**保证可操作性 - **专门保留“有价值的注释”小节**Comments that are actually valuable用于正向强化优秀模式——这不是客套而是让评审在“挑毛病”之外也能沉淀可复制的良好注释范例 - **Notes for synthesizer 小节**是给下游汇总节点看的用于标注与其他评审方面的重叠或需要维护者特别留意的模式。 若注释整体干净则按命令要求写入 ## Findings\n\nComments are accurate and capture non-obvious WHY where present. 并直接结束——**不要为了凑发现而制造问题**。这一“禁止编造问题”的要求与代码评审命令中的 “Dont manufacture issues” 一脉相承是整个评审体系可靠性的底线。 产物文件被下游消费的链路是maintainer-review-synthesize 节点读取 $ARTIFACTS_DIR/review/ 下所有评审产物含 comment-quality-findings.md进行跨方面去重、按严重度归并最终写成 $ARTIFACTS_DIR/review/synthesis.md 与可直接发到 PR 的 $ARTIFACTS_DIR/review/review-comment.md见 [maintainer-review-synthesize.md](https://link.gitcode.com/i/9ef76a33b9235340c914362acafa3e03)。因此注释质量评审只需写好产物文件后续的汇总与发布由工作流自动接续。 --- ## 六、Phase 4RETURN——单行摘要与质量门禁 评审完成时Agent 只需返回一行固定格式的摘要完整发现留在产物文件中由 synthesize 读取Comment-quality review complete. HIGH, MEDIUM, LOW findings. Quality: good|minor-issues|significant-rot-risk.【免费下载链接】ArchonThe first open-source harness builder for AI coding. Make AI coding deterministic and repeatable.项目地址: https://gitcode.com/GitHub_Trending/archon3/Archon创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考