Token导航 LogoToken导航TokenDH.com
AI 工具权限需确认github未标认证来源可访问clear审计提醒

commit-convention提交约定

Agent Skill

commit-convention 用于处理 GitHub 仓库、Issue、Pull Request 和代码协作信息,适合在 Codex、Claude、Cursor、Gemini CLI 中需要围绕仓库状态、代码变更或协作事项进行整理时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态,以及是否会触发联网、命令执行或文件读写。

总安装

629

周安装

27

GitHub Stars

公开资料未说明

下载量

220
CodexClaudeCursorGemini CLI

安装说明

本站只整理中文说明和来源信息,不托管安装包,也不代用户安装。

GitHub

来源数

3

许可证

MIT

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手,先确认命令和权限,再让它执行。

请帮我安装这个 Agent Skill:commit-convention(提交约定)
来源仓库:https://github.com/ab300819/skills
仓库路径:skills/commit-convention
安装命令:
npx skills add https://github.com/ab300819/skills --skill commit-convention
安装前请先检查当前环境是否支持对应 CLI,并向我确认将要执行的命令、安装目录、联网范围和文件读写权限;确认后再执行。

命令行安装

复制命令到本机终端执行。不同来源提供的安装方式可能略有差异;本站展示可直接复制的安装命令,安装前请核对来源页面。

skills.shnpx skills
npx skills add https://github.com/ab300819/skills --skill commit-convention

简介

commit-convention 为提交信息提供格式指导和风格决策支持,不直接执行 git 操作。

  • 优先学习项目历史提交风格,若无明显规律则回退至 Conventional Commits 规范。
  • 自动匹配项目语言习惯(中/英文),确保提交信息风格一致。
  • 使用前请确认是否允许读取 git 日志及是否依赖特定提交约定,避免与项目规范冲突。
  • 适用宿主包括 Codex、Claude、Cursor、Gemini CLI,接入前应确认版本、权限和运行环境要求。

SKILL.md

Commit Convention

该 Skill 不直接执行 git commitgit add 操作,而是为当前 Agent 提供提交信息的决策指导格式标准

核心策略

1. 风格学习(优先)

在生成提交信息前,必须先观察项目已有的提交习惯:

  • 执行 git log -n 5 --oneline
  • 匹配历史:如果项目习惯使用特定的前缀(如 [FEAT]Update: 等)或语言习惯,应优先模仿并保持一致。
  • 语言一致性:如果历史记录全是中文,则使用中文描述;如果全是英文,则使用英文。

2. 规范回退(Fallback)

如果项目提交记录为空、无明显规律,或项目明确要求使用规范化提交,请遵循 Conventional Commits 规范:

<type>(<scope>): <subject>

<body>

<footer>

Type 类型定义

  • feat: 新功能
  • fix: 修补 bug
  • docs: 文档变更
  • style: 不影响代码含义的变更(空白、格式、缺少分号等)
  • refactor: 重构(既不是修复 bug 也不是添加特征的代码更改)
  • perf: 改进性能
  • test: 添加缺失测试或更正现有测试
  • build: 影响构建系统或外部依赖项的更改
  • ci: 更改 CI 配置文件和脚本
  • chore: 其他不修改 src 或测试文件的更改
  • revert: 回退之前的提交

Subject 格式

  • 使用祈使句(如 "add" 而不是 "added")。
  • 结尾不加句号。
  • 首字母小写(除非是专有名词)。
  • 长度控制在 50 字符以内。

操作指令 (仅供 Agent 参考)

当 Agent 需要生成提交信息时,应按以下逻辑思考:

  1. 观察:使用 git log -n 5 --oneline 观察项目风格。
  2. 判断

- 发现既定规律?→ 模仿该规律。 - 发现 Conventional Commits 模式?→ 遵循本规范。 - 初始提交/无规律?→ 采用 Conventional Commits。

  1. 撰写

- 简洁的 Subject。 - 必要时提供 Body(解释 Why 而不是 How)。 - 关联 Issue(如 Closes #123)。

注意事项

  • 严禁过度设计:不要生成过于复杂的提交信息,除非变更确实复杂。
  • 原子性:建议一个提交只做一件事。如果发现变更过多,建议提示用户拆分提交。
  • 禁止执行命令:本 Skill 仅提供“信息建议”,执行操作由主 Agent 决定。

适合场景

01

用户想查找某类 Agent Skill 时

02

需要根据任务场景推荐可安装能力包时

03

需要对比不同来源的安装命令和来源信息时

04

需要参考平台分布和安装热度时

能力概览

能力 1

按任务关键词查找相关 Skills

能力 2

展示可复制的安装命令

能力 3

保留来源站点、仓库和原始说明,方便继续核验

能力 4

补充不同宿主或平台的使用分布数据

能力 5

展示第三方安全扫描或审计结果

安装后应在对应宿主中按原始 README 的触发条件使用;具体调用方式请以来源页面和 README 为准。

平台分布

Claude Code

27%
按下载量换算59

Gemini CLI

24.43%
按下载量换算54

Antigravity

16.42%
按下载量换算36

OpenCode

13%
按下载量换算29

windsurf

8.28%
按下载量换算18

Codex

3.63%
按下载量换算8

安全审计

Gen Agent Trust Hub

可疑

Socket

通过

Snyk

通过

权限和风险

权限需确认

当前来源未能明确判断权限范围,默认进入异常复核队列。

安装前确认

本站仅展示第三方公开信息,不托管安装包,不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。来源安全扫描存在 warning/failed 结果,不能写成本站确认安全。

来源信息

继续浏览同类 Skills