关于 yeet
yeet 是一项根据仓库证据创建和更新 GitHub 贡献的技能,涵盖 PR、议题、讨论和评论,并提供模板、幂等性及发布指导。
主要功能
- 01PR、议题和讨论工作流
- 02创建、更新及评论操作
- 03仓库上下文辅助工具
- 04检查并渲染 YAML 议题表单
- 05发布与幂等性指导
适用场景
- 01根据仓库改动创建 PR
- 02按对应工作流提交或更新议题
- 03发布或编辑讨论评论
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ paulrberg/ agent-skills --skill yeet安装后在 Claude Code 中输入/yeet确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlfixtures/issue-form.ymlreferences/comment-discussion.mdcomment-issue.mdcontext.mdcreate-discussion.mdcreate-issue.mdcreate-pr.mdissue-claude-code.mdissue-codex-cli.mdissue-sablier.mdposting.mdupdate-discussion.mdupdate-issue.mdupdate-pr.mdwriting.mdscripts/get-macos-version.shissue-form.pyyeet-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 以及撰写的贡献文本必须保持原样,不加修饰。