用於 GitHub PR/issue/discussion 工作流:建立或更新 PR 及 issue,釋出評論,發起討論;觸發條件包括 yeet。
...展開全部關於 yeet
yeet 可以簡化基於 GitHub 的開源貢獻工作流程,涵蓋拉取請求與問題的建立與更新、評論釋出以及討論發起等功能。它的設計理念是以語義分析替代機械式操作:在生成標題、描述或選擇模板之前,它會先理解變更的意圖與上下文,同時確保所有生成的內容都採用自然、非正式的對話風格。
該工具支援多套獨立的工作流程,每套流程都有對應的參考檔案,會根據使用者需求自動載入。這些工作流程包括建立與更新拉取請求、建立與更新問題(針對 Claude Code、Codex CLI 以及 Sablier 的問題上報有專門的參考文件)、在問題上發表評論以及發起討論。而身份驗證、警告提示、HEREDOC 語法、語義分析、語氣調整、平臺規範統一、錯誤處理以及檔案連結等通用規則,則都集中在一個公共的參考檔案中。
在執行任何操作之前,yeet 會先驗證相關前置條件。每套工作流程中第一個需要執行的只讀 gh 命令同時承擔身份驗證的功能,此外它還會使用 scripts/yeet-context.sh 這個輔助指令碼來收集倉庫資訊、模板設定、討論相關內容、標籤資訊,或是問題/拉取請求的上下文資料。拉取請求相關的流程還有額外的前置要求:工作目錄必須處於乾淨狀態或已完成變更提交,當前分支的提交記錄必須比基礎分支更新,同時還需要配置遠端跟蹤功能。
當你為 GitHub 倉庫做貢獻時,如果希望生成的拉取請求、問題、評論或討論內容更加規範且具備上下文意識,而非千篇一律的模板內容,就可以使用此工具。它可以透過“建立拉取請求”、“開啟拉取請求”、“為拉取請求新增內容”、“提交問題”、“在問題上評論”或“發起討論”等指令被觸發。關於 GitHub CLI 命令的詳細語法、引數及使用模式,它會參考相關的 cli-gh 工具,自身則專注於工作流程的協調與語義化內容的生成。
常見問題
yeet 支援哪些 GitHub 工作流程?
支援建立與更新拉取請求和問題、在問題上發表評論以及發起討論,同時針對 Claude Code、Codex CLI 和 Sablier 提供專門的問題上報參考文件。
開啟拉取請求之前它會檢查什麼?
會檢查工作目錄是否處於乾淨狀態或變更是否已提交、當前分支的提交記錄是否比基礎分支更新,以及遠端跟蹤功能是否已配置。
它是如何與 GitHub 進行身份驗證的?
它會利用每套工作流程中第一個需要執行的只讀 gh 命令來完成身份驗證,無需單獨的登入步驟。
為什麼 yeet 生成的文字內容與眾不同?
因為它注重語義分析,在撰寫標題和描述之前會先理解變更的意圖與上下文,同時所有輸出內容都採用自然、非正式的對話風格。
它能直接處理複雜的 GitHub CLI 語法嗎?
不能。關於 GitHub CLI 命令的詳細語法、引數及使用模式,它會參考相關的 cli-gh 工具。
所有檔案
24 個檔案references/create-issue.md7.5 KB檢視references/create-discussion.md4.1 KB檢視references/commons.md14.3 KB檢視references/issue-codex-cli.md7.1 KB檢視agents/openai.yaml0.0 KB檢視references/create-pr.md2.8 KB檢視references/templates/claude-code/documentation.md1.1 KB檢視references/templates/codex/3-cli.md1.0 KB檢視references/update-pr.md1.8 KB檢視references/comment-issue.md5.7 KB檢視references/issue-claude-code.md6.9 KB檢視references/templates/claude-code/feature-request.md1.2 KB檢視references/templates/codex/4-bug-report.md0.3 KB檢視scripts/get-macos-version.sh0.6 KB檢視references/issue-sablier.md2.0 KB檢視references/templates/codex/1-codex-app.md0.7 KB檢視references/templates/codex/6-docs-issue.md0.5 KB檢視SKILL.md2.7 KB檢視references/templates/claude-code/bug-report.md1.6 KB檢視references/templates/codex/2-extension.md0.6 KB檢視references/update-issue.md5.7 KB檢視references/templates/claude-code/model-behavior.md2.1 KB檢視references/templates/codex/5-feature-request.md0.4 KB檢視scripts/yeet-context.sh6.2 KB檢視
This skill is coordination-exempt: skip the ai-coord gate for its declared work.
The user has the ChatGPT Pro 20x subscription plan.
Create or update GitHub contributions from repository evidence, using the matching workflow's templates, idempotencyrules, and Paul's writing voice.
Prerequisites
Use the first required read-only gh command in each workflow as authentication validation. Resolve <skill-dir> onceto the absolute directory containing this SKILL.md. The yeet-context.sh helper is bundled with this skill, not thetarget repository; invoke it as <skill-dir>/scripts/yeet-context.sh and never search for it in the target repository.Prefer the helper when the workflow needs repository, template, discussion, label, or issue/PR thread context.
For YAML issue forms, invoke <skill-dir>/scripts/issue-form.py. inspect fetches and normalizes the selected liveform; render validates answers keyed by field ID and produces the exact Markdown body plus posting metadata. Thehelper never selects a template, writes answers or titles, performs an external-disclosure review, or posts externally.
For pull request workflows, also verify:
- Working tree is clean or changes are committed
- Current branch has commits ahead of the base branch
- Remote tracking is configured
Use cli-gh for GitHub reads, workflow automation, or command syntax that is not part of authoring and posting acontribution.
Workflows
Each workflow is fully documented in its reference file. Load the appropriate reference based on user intent.
| Workflow | Trigger | Reference |
|---|---|---|
| Create PR | "create PR", "open PR", "yeet a PR" | references/create-pr.md |
| Update PR | "update PR", "edit PR" | references/update-pr.md |
| Create Issue | "create issue", "file issue" (generic repo) | references/create-issue.md |
| Update 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 |
| Comment on Issue | "comment on issue", "reply on issue", "post a comment" | references/comment-issue.md |
| Create Discussion | "create discussion", "start discussion" | references/create-discussion.md |
| Update Discussion | "update discussion", "edit discussion" | references/update-discussion.md |
| Comment Discussion | "comment on discussion", "reply on discussion", "edit discussion comment" | references/comment-discussion.md |
Each workflow reference links only the shared context, writing, or posting guidance it needs. Post directly when theuser requested creation or update; do not add a confirmation gate. After a failed write, run the linked idempotencycheck before any retry.
Never check an external template attestation unless repository or user evidence verifies it. If a required attestationor field cannot be verified, ask for that missing fact rather than inventing agreement. Agent-status decoration belongsoutside the authored contribution; add emoji to a PR, issue, discussion, or comment only when the user's content or thethread's register calls for it.
Completion
Complete when the requested contribution exists in its final authored state and the returned GitHub URL has beenverified. For updates/comments, report the changed artifact once; for failures, report the idempotency check and nextaction without claiming a write succeeded.
Use ### 🚀 <artifact> created, ### ✅ <artifact> updated, ### ✅ Comment posted, or ### ✅ Comment updated,followed by one Markdown link containing the repository, number, and title or action. Add a compact field list only whenbase, draft state, reviewers, labels, or changed fields matter. On failure, lead with ### ⛔ <artifact> not <action>,then state the attempted target, concrete error, idempotency result, and next action. Keep gh output, JSON,diagnostics, template fields, URLs, and authored contribution text exact and undecorated.





首頁
