关于 run-github-project
供 Agent 操作 GitHub Project 的工作流技能，涵盖审查、设置、处理下一项和清空队列。它依据最新看板状态与限定权限决策，并明确规定责任划分、状态保留和安全恢复。
主要功能
- 01审查、设置、下一项和清空模式
- 02以当前 Project 状态为准
- 03区分控制器与工单 Agent 的职责
- 04保留受阻工作及其状态
- 05重试未知结果前先核对状态
- 06规定每项工单的检查与报告
适用场景
- 01选择获准处理的下一项问题
- 02审查或验证 Project 绑定
- 03保留受阻工单及其状态
- 04从结果不明的变更或发布中恢复
安装
复制下面的命令，在终端中运行。
npx skills add https:/安装后在 Claude Code 中输入/run-github-project确认已加载。
包含的文件
除 SKILL.md 外，安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/agent-routing.mdauthority-and-pauses.mdbehavioral-review.mddrain-scheduler.mdexecution-controller.mdhuman-frontier.mdnormalized-ticket.mdpr-review-timing.mdproject-config.mdremote-reconciliation.mdreview-and-setup.mdreview-contracts.mdsubagent-selection.mdticket-lifecycle.mdtodo-lane.mdtriage-lane.mdwayfinder-lane.mdworkflow-providers.mdscripts/rank_tickets.pytest_rank_tickets.pytest_watch_project.pywatch_project.py详细介绍
运行 GitHub Project
核心原则
Project 是实时控制平面：最新看板状态和本次运行的操作专属授权决定每一项声明、写入和完成操作。
默认泳道为 Backlog → Todo → Ready to implement → In progress →
Done；通过可信绑定中已验证的选项 ID 解析这些泳道。
不变量
- 列权限： 当前列成员身份授权处理工单，而不是状态转换历史。Backlog 为只读：绝不在此认领、规划、分流、关闭 Epic 或恢复清理；只有人工才能将项目移出。自动工作从 Todo 开始。
- 实时权限： 认领、选择、合并、恢复和完成都需要完整的最新状态；缓存和不完整读取只能作为提示；仅重新获取已更改或未经验证的记录。即使使用复用的快照，也要在每次认领、写入或合并前重新检查操作专属权限；排序器的符合条件状态不授予任何权限。
- 控制器所有权： 只有控制器可以认领、分配、修改共享 Project 状态、合并、关闭 issue 和协调状态；工单 Agent 仅拥有自己的工作树、分支和非合并 PR 变更。
- 未知结果： 对未知或失败的修改或发布操作，必须先核对结果，再重试、释放容量或报告成功。
- 保留状态： 将受阻、受依赖条件限制和需要人工处理的工作保留在其前沿，并保留所有者、认领、槽位、草稿、产物、授权和预算；绝不能为了清空队列而更改状态。释放的容量只能在空闲槽位中恢复使用。
- 保留所有者： 反馈、修复和修订都保留原有所有者、认领和槽位，不重置为 Todo/Ready；在最终头部重新执行受影响的检查和审查，绝不依赖较早头部的证据。
- 不得臆造门槛： 绝不推断所提供状态中不存在的权限、容量限制、提供方或前置条件；其他工作等待时，独立且可运行的工作继续进行。
- 提供的状态： 根据提供的完整状态决定审查、设置或分析，不再读取 Project 或仓库（仍须读取参考资料）；评估所描述的环境，而不是当前工作区中缺失的提供方。经过验证的拟议差异即使尚未写入或提交，也属于
configuration-ready-to-commit。配置文件选择不会调用路由服务，也不会授予认领或合并权限；忽略旧版路由字段，不要编辑它们。 - 不得走捷径： 续期或修订绝不恢复已暂停的 CI、授予实时轮次或重置资格。未知或过时的证据会阻止依赖项；重大架构变更需要完整的重新规划和审查；权限或资格发生变化时，需要利益相关方或来源方作出决定。
经过验证的交接涵盖 deliver-spec 下范围内的实现、测试和修复，并包含一次独立的集成候选审查。重新规划保留已验证的计划状态；真正需要人工处理的工作则返回决策暂停状态。drain 会在刷新前，将已验证的权限暂停项以及符合条件的终止性必需 CI 认领项移出容量；在 next 中，必需 CI 停滞会继续占用其槽位。错误的计划切入点在一次诊断和两次修复后仍然失败时，需要重新规划资料包；重复出现的非 CI 失败仍由其所有者负责，所有者需请求一名按能力选择的只读证据助手，并且仅在获得新指示后恢复，否则报告确切的阻塞原因。
选择模式
review：仅检查或说明。setup：仅配置或验证绑定。next：默认模式；最多选择一个问题；启动时的合并决策确定后，不再等待，直接返回waiting-for-human。命名的 Wayfinder 子项仍使用next。drain：仅在明确要求清空队列／运行全部／直到队列为空时使用；不限制工单数量。只剩远程或人工等待项时，运行只读的项目监视器，绝不替换 Refresh Gate。
依据运行权限，在启动时一次性确定合并权限：遵循明确的合并或禁止合并指示；否则在交付继续进行时询问，并采用 60 秒后默认拒绝的截止时间。没有权限时，交付已就绪的 PR，仅暂停合并。
执行前阅读
| 模式 | 必读参考资料 |
|---|---|
review 或 setup | 检查与设置 |
next 或 drain | 先阅读检查与设置以验证绑定，再阅读执行控制器和工单生命周期 |
执行时还须先阅读工作流提供方（绝不隐式安装），以及权限与暂停；开始验收工作前还须阅读检查约定。在处理清空队列工作前，drain 须完整阅读清空队列调度器。即使只是分析，也要先阅读对应章节：
| 问题涉及 | 阅读 |
|---|---|
| 分发前就绪状态、资格判定、实时执行轮次 | 无人值守就绪状态 |
| 容量、共享路径、刷新、时序、CI 停放 | 清空队列调度器 |
| 规划器让出、修订、重新规划 | 待办事项通道 |
| 配置更改或续期 | 项目配置 |
| Agent 配置文件或助手分配 | Agent 路由 |
回答各项内容
针对每张工单或每个场景，给出分类和安全的下一步操作、准确保留的状态和恢复所需证据（绝不能用受阻操作自身的结果作为证据），以及执行前要重复检查的内容。 对于重复周期，比较上一周期的证据，并给出一个范围明确的下一步操作或准确的阻塞原因。
最终报告
遵循对应通道的终止状态和报告约定。先说明结果、带有恢复条件的阻塞项，以及用户的下一步操作；未解决的前置条件属于部分完成，而非队列为空；审计详情放在最后。按照时序流程报告时间区间。