用途:在需要查看或操作 GitHub 状态时使用,覆盖 issue、pull request、checks、review、workflow 运行日志、标签、release 以及 PR 生命周期操作。仅做本地 git 工作(提交、rebase、分支清理、worktree 管理)而无需 GitHub 操作时不适用。
主要能力:用 gh CLI 完成上述查询与写入;提供合并前规则审查流程(拉取 diff 与仓库自身规则文件交叉核对,给出阻断/应改/无异议分档建议,不自动合并);提供作者侧评审修复流程(拉取评审含行内与会话评论、checkout 分支、逐条修复、push 回原分支并请求重审,不自动合并);支持 dry-run 或预览,删除、覆盖、发送、发布、写远端状态前先征求确认。
使用方式:用自然语言说明目标并提供必要输入,例如文件、URL、repo、workspace、proposal、vault 或平台账号状态。查询优先使用 --json 与 --jq 获得可读输出。仓库解析顺序为 --repo 参数、当前 git remote、GITHUB_REPOSITORY 环境变量、可选私有配置 ~/.config/soia-skills/soia-dev-github-ops/config.yml,仍不明确时询问用户。
依赖与安装:推荐安装整个领域插件: claude plugin marketplace add soia-team/soia-open-skills claude plugin install soia-dev@soia 仅装本技能可用 npx 路线,会落入共享真源 ~/.agents/skills,若同时装插件会出现两份索引且各自漂移,建议二选一: npx skills add soia-team/soia-open-dev-skills -g -a '*' -s soia-dev-github-ops -y 配置可复制 assets/config.example.yml。GitHub token、cookie、session 必须由 gh auth login 官方凭据存储或系统凭据库管理,不得写入配置、仓库、正文或日志。
安全限制:只读查询在目标仓库已知后可直接执行;写入操作需当前请求中明确意图;高影响操作(gh pr merge、release 创建、分支或标签删除、对生产 dispatch workflow、授予/撤销协作者权限等)须显式最终确认。协作者权限变更最敏感,不得仅凭历史对话推断仓库、用户名或权限级别。执行前用 gh auth status 检查认证,缺失或过期应停止并说明需配置内容。
输出与数据:默认不创建本地 state 或 cache;回执只记录 repo、对象编号、状态、URL 和必要错误摘要,私有正文、协作者信息和日志按最小披露脱敏。验收要求对只读查询核对编号、URL、分支与状态字段,写操作后须用独立只读查询复核远端对象,不能以退出码 0 当作验收。其他事实(如具体价格、更多平台支持)暂未提供。