能力展示

gh-issue-comment-monitor 把 GitHub Issue 评论变成相对本地 checkpoint 的有界增量结果。主 Agent 只处理本轮返回评论，处理成功后确认该批 checkpoint，下次从新位置继续。

真实公开运行：增量 1 条，再次检查 0 条

打开真实运行报告，可逐步复核首次读取、处理基线、增量结果和再次检查为空的交付件。

运行步骤	真实输入与结果	可打开的交付件
首次只读获取	microsoft/vscode#1 的尾部 2 条公开评论：157765447、157765938	首次结果 JSON
确认本地基线	处理第一条后，以 157765447 创建 checkpoint	初始 checkpoint
检查基线之后	has_updates=true，实际只返回评论 157765938，正文为“Done!”；状态未自动更新	增量 updates JSON
处理本轮结果	从已处理的 updates 精确确认候选 ID 157765938，省略编辑时间游标	确认后的 checkpoint
再次检查	has_updates=false、new_comments=[]，原 checkpoint 保留	空结果 JSON

示例于 2026-10-16 使用本仓入口脚本实际只读调用 GitHub API。来源是 microsoft/vscode Issue #1，可对照基线评论和返回评论。这些是 2015 年发布的历史公开评论，本次运行以本地基线回放增量路径；“1 条新评论”指相对该基线新增，并非本次运行期间刚发布。

公开 JSON 仅把本机 state_file、updates_file 路径替换成示例文件名，保留实际评论 ID、作者、时间、URL、正文和脚本返回候选。初始和最终确认状态主动省略 last_seen_comment_updated_at，让下次只按 ID 扫描；这是明确的本地确认策略，并非声称脚本默认如此。没有写入凭据，也没有发布或修改 GitHub 评论。来源记录与脚本 SHA-256说明了采集、脱敏及确认方式。示例状态仅供阅读，不要作为自己的生产 checkpoint 使用。

覆盖的能力

• 从仓库、Issue 编号和本地 checkpoint 取回新增评论。
• 输出包含评论 ID、作者、时间、URL 和正文的机器可读 JSON。
• 检查阶段返回候选 checkpoint，保持 state_updated=false。
• 成功处理后确认同一批快照，再次检查时不重复返回该条评论。
• updates 每次覆盖，作为本轮输入，不累计保存完整 Issue 历史。

发起任务

请检查这个 GitHub Issue 有没有新的回复，沿用当前工作的 checkpoint；只处理返回的新评论，处理成功后再确认这一批的 checkpoint，并说明是否仍有下一批。

运行命令、输入输出路径和安全确认步骤见使用方式，环境准备见依赖说明。普通使用由主 Agent 完成，没有必需的子 Agent。

能力边界

这个示例证明单批增量读取和处理后为空的结果，不证明持续自动调度、扫描上限、并发写入或访问失败的处理。首次没有 checkpoint 时只读取最后一页的尾部；--limit 可限制返回条数，truncated=false 也不代表全部未处理评论都已返回。当前实现不返回 checkpoint 之前旧评论的后续编辑。

脚本只读 GitHub；摘要、后续行动与 checkpoint 的处理成功条件由主 Agent 负责。--update-state 是抓取后立即写本地状态，不是“评论已处理”的证明；需要确认已处理内容时，应使用同一 updates 的候选快照。