mcpField
Y
yeet

yeet

github.com/paulrberg开发1022.6k 次安装1 天前更新
代码仓库

关于 yeet

yeet 是一项根据仓库证据创建和更新 GitHub 贡献的技能,涵盖 PR、议题、讨论和评论,并提供模板、幂等性及发布指导。

主要功能

  1. 01PR、议题和讨论工作流
  2. 02创建、更新及评论操作
  3. 03仓库上下文辅助工具
  4. 04检查并渲染 YAML 议题表单
  5. 05发布与幂等性指导

适用场景

  1. 01根据仓库改动创建 PR
  2. 02按对应工作流提交或更新议题
  3. 03发布或编辑讨论评论

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/paulrberg/agent-skills --skill yeet

安装后在 Claude Code 中输入/yeet确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

agents/
openai.yaml
fixtures/
issue-form.yml
references/
comment-discussion.md
comment-issue.md
context.md
create-discussion.md
create-issue.md
create-pr.md
issue-claude-code.md
issue-codex-cli.md
issue-sablier.md
posting.md
update-discussion.md
update-issue.md
update-pr.md
writing.md
scripts/
get-macos-version.sh
issue-form.py
yeet-context.sh

详细介绍

GitHub 贡献工作流

此技能不受协调机制约束:执行其声明的工作时,跳过 ai-coord 检查。

根据仓库证据,使用相应工作流的模板、幂等规则和 Paul 的写作风格,创建或更新 GitHub 贡献。

前提条件

在每个工作流中,使用第一个必需的只读 gh 命令验证身份验证。将 <skill-dir> 一次性解析为包含此 SKILL.md 的绝对目录。

此技能(而非目标仓库)附带 yeet-context.sh 辅助脚本。通过 <skill-dir>/scripts/yeet-context.sh 调用。切勿在目标仓库中搜索此脚本。当工作流需要仓库、模板、讨论、标签或 Issue/PR 线程上下文时,优先使用此辅助脚本。

对于 YAML Issue 表单,调用 <skill-dir>/scripts/issue-form.py。inspect 会获取并规范化选定的实时表单。render 会验证以字段 ID 为键的答案,并生成准确的 Markdown 正文和发布元数据。此辅助脚本不会选择模板、填写答案或标题、执行外部披露审查,也不会对外发布。所有 Issue 创建和更新工作流在解析或传递元数据之前,都必须遵循 references/context.md > Issue Metadata Permissions。渲染后的模板元数据描述的是请求的值,而非查看者有权应用的值。

对于拉取请求工作流,还需验证:

  • 工作树干净或更改已提交
  • 当前分支的提交领先于基分支
  • 已配置远程跟踪

对于不属于贡献撰写和发布的 GitHub 读取、工作流自动化或命令语法,请使用 cli-gh。

工作流

每个工作流都在其参考文件中有完整说明。根据用户意图加载相应的参考文件。

工作流触发条件参考文件
创建 PR"create PR", "open PR", "yeet a PR"references/create-pr.md
更新 PR"update PR", "edit PR"references/update-pr.md
创建 Issue"create issue", "file issue"(通用仓库)references/create-issue.md
更新 Issue"update issue", "edit issue", "relabel issue"references/update-issue.md
Claude Code Issue"Claude Code issue", "report bug in CC"references/issue-claude-code.md
Codex CLI Issue"Codex issue", "report bug in Codex"references/issue-codex-cli.md
Sablier Issue"Sablier issue", "sablier-labs issue"references/issue-sablier.md
评论 Issue"comment on issue", "reply on issue", "post a comment"references/comment-issue.md
创建讨论"create discussion", "start discussion"references/create-discussion.md
更新讨论"update discussion", "edit discussion"references/update-discussion.md
评论讨论"comment on discussion", "reply on discussion", "edit discussion comment"references/comment-discussion.md

每个工作流参考文件只会链接其所需的共享上下文、撰写或发布指南。所有撰写的正文或评论都必须遵循 posting.md > Model Co-signature。用户要求创建或更新时,直接发布。不要添加确认环节。写入失败后,重试前先运行相关的幂等性检查。

除非仓库或用户提供的证据能够验证外部模板认证,否则绝不要检查它。如果无法验证必需的认证或字段,应询问缺失的信息,而不是臆造共识。Agent 状态标记应放在撰写内容之外。只有当用户提供的内容或讨论串的语气需要时,才在 PR、Issue、讨论或评论中添加表情符号。

完成

当所请求的贡献已处于最终撰写状态,且返回的 GitHub URL 已验证时,工作流即告完成。对于更新或评论,只报告一次更改后的内容。根据回读结果判断执行结果,而非命令的退出状态:创建可能成功,但元数据变更随后可能失败。

使用 ### 🚀 <artifact> created、### ✅ <artifact> updated、### ✅ Comment posted 或 ### ✅ Comment updated,后跟一个包含仓库、编号和标题或操作的 Markdown 链接。只有当 base、草稿状态、审阅者、标签或变更字段很重要时,才添加简洁的字段列表。对于已验证的部分成功,报告已创建或更新的内容,并指出遗漏或失败的元数据。

只有在确认未完成时才使用 ### ⛔ <artifact> not <action>。如果回读结果不明确,应报告结果尚未验证。说明具体错误、幂等性检查结果和下一步操作。gh 输出、JSON、诊断信息、模板字段、URL 以及撰写的贡献文本必须保持原样,不加修饰。

评论

支持 Markdown