Community寫作與編輯github.com

giostriquer/agent-workshop

為 Claude Code、Codex 等 CLI 工具提供即裝即用的代理、技能與慣例,支援規格驅動開發。

agent-workshop 是什麼?

此技能為開發者提供一個標準化的「推送」工作流程,適用於 Claude Code、Codex 及類似命令列介面(CLI)的代理環境。它能自動化偵測目前 Git 分支、安全拉取最新變更、檢查差異、根據慣例提交(如 conventional commits 與 `docs/change-log.md`),並將變更推送回遠端。核心優勢在於減少手動 Git 操作錯誤,確保提交訊息格式一致,並強制使用安全旗標(禁止 `--force` 或 `--no-verify`)。支援透過 `Co-Authored-By:` 等標準尾部行進行歸屬,並在失敗時明確停止並報告錯誤。此技能以「當前檢出的分支」為運作基礎,無需指定特定分支。

相容平台✓Claude Code✓Codex CLI~Cursor
npx skills add giostriquer/agent-workshop

Installed? Explore more 寫作與編輯 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

推送

將變更提交並推送至目前分支。

此技能不限定於特定分支——它始終作用於目前檢出的分支。請根據您專案的提交歸屬偏好,調整下方第 8 步的尾部行。

快速開始

  1. 使用 git branch --show-current 偵測目前分支。
  2. 若無目前分支名稱,請停止並顯示錯誤。
  3. 使用 git pull --ff-only origin <目前分支> 拉取最新的 origin/<目前分支>。若失敗,請停止並顯示錯誤。
  4. 在暫存前檢查差異。
  5. 若相關,優先使用 docs/change-log.md 中最新且有意義的更新作為提交訊息來源。
  6. 若變更日誌更新並非變更的真正來源,則從差異中主要變更的區域推導訊息。
  7. 使用 git add -A 暫存所有變更。
  8. 使用多行訊息提交,並附加專案的標準尾部行(通常為 Co-Authored-By: 行或類似的歸屬文字;依專案而定)。
  9. 使用 git push origin <目前分支> 推送。
  10. 以一句話報告分支、提交雜湊值與主旨。

提交訊息指引

使用簡潔的慣例式主旨,例如:

  • docs: 適用於文件或路由更新
  • feat: 適用於新功能、系統或內容
  • fix: 適用於行為修正
  • refactor: 適用於結構性變更,不涉及重大行為改變
  • test: 適用於有意義的測試範圍新增或修改
  • chore: 適用於不適合其他分類的維護工作

對於正文:

  • 總結最有意義的變更區域
  • 每個主要變更偏好使用一行
  • 保持基於實際差異

當使用 docs/change-log.md 作為來源時:

  • 偏好使用最新且實際描述核心變更的章節或條目
  • 當變更日誌更新是附帶性的,不要強制使用從變更日誌推導的訊息

當不使用變更日誌作為來源時:

  • 從差異中最重要的變更區域推導主旨
  • 若差異過於模糊,無法有把握地總結,請向使用者詢問提交訊息,而非猜測

規則

  • 始終使用目前檢出的分支。
  • 絕不使用 --force 或 --force-with-lease。
  • 絕不使用 --no-verify。
  • 明確失敗:若某一步驟失敗,請停止並顯示錯誤。

相關技能