SuperAPI AI 工具集

parley

编程与开发

查看项目

更新于 10-16 01:19

技能介绍

用途:处理 GitHub Pull Request 上未解决的评审评论。属 /scrutiny 与 /forge 的同类技能,共用同一二进制与配置文件 ~/.scrutiny/config.toml。

主要能力:通过 GraphQL 拉取未解决评审线程;询问团队成员、验证者、传道者与 spawn 模式;运行修复智能体;由宿主完成提交与推送;随后用 addPullRequestReviewThreadReply 在每个线程下回复。产物写入 <repo>/.scrutiny/<pr>/,包括 parley-comments.json、parley-plan.json、parley-fixes.json、parley-reply.json、parley-session.json。

使用方式:推荐脚本编排,先设置 SKILL_ROOT 指向含本 SKILL.md 的文件夹,再用 ensure-bin.sh 取得二进制路径,然后运行 "$SCRUTINY_BIN" parley [--pr <url|number>]。斜杠命令形式:/parley 处理当前分支 PR,/parley <PR-URL> 或 /parley <PR-number> 指定 PR。也支持 IDE 链式分步:parley-fetch、parley-plan-write、parley-reply。

可调参数:团队成员默认 1,不得超过未解决评论数;验证者默认 1,两种模式下均在修复后、传道者前运行;传道者默认 1,仅 isolated 模式用于独立后置检查;spawn 模式默认 isolated,可选 team,team 模式在传道者大于 0 时由 lead 内嵌验证。验证者仅标记,确认已标记 addressed:true 的修复真正解决评论,否则改回 false,并校验 addressed:false 的回复一致性,不修改源码。

限制与规则:智能体不得执行 git commit / push / gh reply,由宿主负责发布与回复;每个线程都要有 parley-fixes.json 条目;回复必须用对应线程 id;v1 不自动 resolve。headless 默认 true,设为 false 可在当前界面(tmux/zellij、macOS Terminal/iTerm2)以可见窗口运行;非 claude 客户端或不支持界面会退回 headless。推送失败时,宿主先静默运行仓库 pre-push 检查,失败则用 parley-prepush-plan 拆分日志,再按分块并行运行 parley-push-fix,重试次数受 [parley].prepush_fix_max_loops 限制,认证或远端推送错误跳过智能体。其他细节如具体价格、平台支持范围暂未提供。