Community写作与编辑github.com

giostriquer/agent-workshop

为Claude Code、Codex等CLI工具提供即用的代理、技能和规范,支持规范驱动开发。

agent-workshop 是什么?

此技能git-push为基于CLI的AI编码代理(例如Claude Code、Codex)提供标准化、可重复的git提交推送工作流。它通过强制要求先拉取最新代码、使用约定式提交规范并自动附加项目标准贡献者信息(如Co-Authored-By:),确保提交历史清晰可追溯。支持从docs/change-log.md自动提取提交消息,或在必要时提示用户输入。它严格限制在当前检出分支上操作,并禁用危险选项(如--force),从而避免常见的人为错误。此技能作为giostriquer/agent-workshop项目的一部分,旨在为规范驱动的开发建立一致的工具链约定。

兼容平台✓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 的新对话。

文档

Push

提交并推送更改到当前分支。

此技能不限定特定分支——它始终在当前检出的分支上操作。根据项目对提交归属的偏好,调整下面第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。
  • 大声失败:如果某一步骤失败,停止并上报错误。

相关技能