用途:在 GitHub Pull Request 审查工作流中发布自动化进度评论,为维护者和贡献者提供上下文。评论需自包含,不得引用本地文件路径(如 CustomAgentLogsTmp/),因为 GitHub 用户无法访问本地文件系统。
主要能力:统一评论(每条 PR/Issue 仅一条,含 PR-REVIEW、TRY-FIX、WRITE-TESTS、VERIFY-TESTS 各分区,脚本只更新自己的分区并保留其他分区);通过 <!-- AI Summary --> 标记查找并更新已有评论,避免重复;支持 -DryRun 在本地文件预览;另有独立的 PR 定稿评论(标记 <!-- PR-FINALIZE-COMMENT -->),包含标题、描述与代码审查三部分。
使用方式:脚本位于 .github/skills/ai-summary-comment/scripts/,需 GitHub CLI 认证(gh auth status)。最简用法为提供 PR 编号,例如 pwsh .github/skills/ai-summary-comment/scripts/post-ai-summary-comment.ps1 -PRNumber 27246;try-fix 与 write-tests 脚本可传 -TryFixDir 或 -TestDir 自动加载,或传 -IssueNumber 自动发现最新尝试。DryRun 预览文件默认位于 CustomAgentLogsTmp/PRState/{PRNumber}/ai-summary-comment-preview.md,可用 rm 清理。
适用场景:PR 代理各阶段完成后(pre-flight、tests、gate、fix、report)发布进度;同一 PR 多次审查时追加可折叠的审查会话。
限制:依赖 PowerShell 与 GitHub CLI 认证;评论内容必须自包含;定稿评论在 TitleStatus 为 NeedsUpdate 时应提供 -RecommendedTitle,DescriptionStatus 为 NeedsUpdate 或 NeedsRewrite 时应提供 -RecommendedDescription,缺失仅警告不失败。其余细节暂未提供。