caveman caveman-commit只写意图的 Conventional Commits 技能全解【免费下载链接】caveman why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman项目地址: https://gitcode.com/GitHub_Trending/caveman1/cavemancaveman-commit 是 caveman 仓库中专职生成提交信息的技能它把 Conventional Commits 规则压缩成一套“只写 why、不写 what”的最小规则集并以 slash 命令、自然语言短语两种入口驱动 Agent 产出即贴即用的 commit message。读完本文你将掌握该技能的完整规则体系subject/body/禁写清单、Auto-Clarity 强制场景、边界行为绝不代你执行git commit以及它在仓库中如何被注册为/caveman-commit命令、被 UserPromptSubmit hook 拦截并切换 commit 模式的完整链路。技能定位一条规则集不碰 git 状态技能的 canonical 定义位于 skills/caveman-commit/SKILL.md配套的人类可读说明在 skills/caveman-commit/README.md。SKILL.md 以 YAML frontmatter 声明身份与触发条件name: caveman-commit description: Write a Conventional Commits message compressed to intent only. Use for write a commit, commit message, /commit or /caveman-commit.frontmatter 之后的第一行是全部指令的纲领Write commit messages terse and exact. Conventional Commits format. No fluff. Why over what.即简洁、精确、Conventional Commits 格式、不灌水、意图优先于描述。技能在 docs/technical/skills-hooks-and-plugins.md 的能力总表中被登记为“Terse Conventional Commit message”并明确标注其边界Does not stage, commit, or amend不暂存、不提交、不 amend。Subject line 规则逐条完整继承SKILL.md 的 Rules 一节对 subject 行给出六条硬性约束是技能的核心产出契约格式type(scope): imperative summary其中scope可选type 白名单feat、fix、refactor、perf、docs、test、chore、build、ci、style、revert共 11 种祈使语气用 add、fix、remove禁止 added、adds、adding长度尽量 ≤50 字符硬上限 72 字符句尾不加句号冒号后的大小写跟随项目既有约定match project convention for capitalization after the colon。第 6 条值得注意技能并不强制某一种大小写风格而是要求先观察项目已有提交再对齐——这让生成的 message 在历史中不突兀。仓库为 Gemini CLI 准备的等价压缩版 prompt 同样内嵌了这些约束见 commands/caveman-commit.tomldescription Generate terse caveman-style commit message prompt Generate a terse commit message for the current staged changes. Conventional Commits format. Subject: ≤50 chars, imperative, lowercase after type. Body: only when why isnt obvious from subject. Why over what. No period on subject.注意 TOML 版的 prompt 把作用对象明确为current staged changes当前暂存改动与 SKILL.md 的 Boundaries 一节呼应技能只读暂存区来写 message绝不主动 stage。Body 规则默认不写四类情况必写Body 的默认策略是跳过Subject 自明时self-explanatory完全不加 body仅当存在以下四类内容时才添加 body非显然的whynon-obvious why、破坏性变更breaking changes、迁移说明migration notes、关联 issuelinked issuesbody 按 72 字符折行列表用-而不是*issue/PR 引用放在结尾格式为Closes #42、Refs #17。禁写清单这些内容永远不出现在 message 里SKILL.md 的 What NEVER goes in 一节定义了一条负面清单这是该技能与普通 commit message 生成器拉开差距的地方禁写内容替代方案This commit does X、I、we、now、currently删掉——diff 已经说明了 whatAs requested by ...使用Co-authored-bytrailerGenerated with Claude Code 或任何 AI 署名不加除非用户自己的规则要求Assisted-by/AI 署名 trailer此时以 trailer 形式追加Emoji不加除非项目约定要求复述 scope 已经表达过的文件名删掉scope 已承载该信息其中 AI 署名条款值得单独说明默认零署名但给用户规则留了后路——若用户项目规范本身要求 AI 署名则以 trailer 而非 body 叙述的形式出现避免污染意图正文。两个完整示例为什么比怎么写更重要SKILL.md 给出两段带 diff 语境的对照示例完整保留如下。示例一diff 是“新增用户 profile 端点且 body 解释 why”。❌ 反例feat: add a new endpoint to get user profile information from the database✅ 正例feat(api): add GET /users/:id/profile Mobile client needs profile data without the full user payload to reduce LTE bandwidth on cold-launch screens. Closes #128subject 只说“加了什么端点”body 回答“为什么要单独拆一个端点”移动端冷启动场景下省流量结尾挂 issue 引用。反例的问题在于它把 diff 里已经可见的 what 又复述了一遍。示例二diff 是破坏性 API 重命名。feat(api)!: rename /v1/orders to /v1/checkout BREAKING CHANGE: clients on /v1/orders must migrate to /v1/checkout before 2026-06-01. Old route returns 410 after that date.要点!标记破坏性变更BREAKING CHANGE:footer 给出迁移截止日和旧路由的失效行为410 Gone。Auto-Clarity四类变更禁止压缩成单行 subjectSKILL.md 的 Auto-Clarity 一节是一条覆盖性规则Always include body for: breaking changes, security fixes, data migrations, anything reverting a prior commit. Never compress these into subject-only — future debuggers need the context.即以下四类变更永远必须带 body不允许压成 subject-only破坏性变更breaking changes安全修复security fixes数据迁移data migrations对先前提交的回滚revert其理由写得很直白未来的排障者需要上下文。这与 Body 规则中“默认跳过”形成互补——常规改动享受极简高风险改动强制保留推理链。边界与退出只产出文本随时可退回详细模式SKILL.md 的 Boundaries 一节划定了技能的行为边界只生成 commit message不执行git commit、不 stage 文件、不 amend输出形态以代码块形式输出可直接复制粘贴退出机制说 stop caveman-commit 或 normal mode 即退回冗长verbose提交风格。README.md 对同一边界做了复述Outputs only the message. Does not stage, commit, or amend. 这意味着该技能可以安全地放进任何提交流程——它没有 git 副作用唯一产出物是待粘贴的文本。注册链路/caveman-commit如何恰好注册一次技能被声明为可由/caveman-commitslash 命令触发但“slash 命令能解析”本身在这个仓库里是被测试守护的契约。tests/installer/slash-commands.test.mjs 针对 issue #470 与 #571 断言每个对外文档化的命令都必须满足双通道注册Gemini 通道commands/name.toml必须存在Gemini CLI 扩展只读 TOML 命令——对应 commands/caveman-commit.tomlClaude Code 通道skills/name/SKILL.md或commands/name.md二者恰好其一。Claude Code 会把commands/*.md当作与skills/*/SKILL.md同一命名空间的扁平技能加载两者同时存在会让同一 slash 命令注册两次3 行 stub 与真正的规则集竞争测试注释中记录了claude plugin details曾列出重复项的现场。对caveman-commit而言Claude Code 侧的唯一提供方就是 skills/caveman-commit/SKILL.md测试中DOCUMENTED_COMMANDS白名单包含它保证这条命令在 Claude Code 里不会被解析成 Unknown command。另外从 skills/registry.json 的preserved_skill_ids列表含caveman-commit与 skills/compile.mjs 的校验逻辑看caveman-commit属于“保留技能”——它不进入编译器的skills数组不注入 native pack / CLI 生成物而是以独立的skills/caveman-commit/目录形式随插件分发由宿主Claude Code 等直接发现compile.mjs 在比对 canonical 技能目录时会显式豁免这些保留 id。这解释了为什么它没有出现在 registry 的skills数组里却仍然是可安装、可触发的正式技能。拦截与模式状态从输入框到[CAVEMAN:COMMIT]徽章输入/caveman-commit后仓库的 hook 链路会把它识别为一个“独立一次性模式”。关键证据在 src/hooks/caveman-parse.js// Modes handled by their own slash commands (/caveman-commit, etc.) — not // selectable via /caveman arg. const INDEPENDENT_MODES new Set([commit, review, compress]);commit是独立模式不能通过/caveman commit选择只能经由它自己的 slash 命令进入用户在自然语言路径误触时会被明确告知而非静默切换。解析主体在 src/hooks/caveman-parse.jsif (prompt.startsWith(/caveman)) { const parts prompt.split(/\s/); const cmd parts[0]; // /caveman, /caveman-commit, /caveman-review, etc. ... if (cmd /caveman-commit || cmd /caveman:caveman-commit) { return { action: set, mode: commit }; }注意它同时接受/caveman-commit与插件命名空间形式/caveman:caveman-commitmarketplace 插件安装下的呈现形态。模式判定后UserPromptSubmit hook src/hooks/caveman-mode-tracker.js 把commit写入模式标志文件src/hooks/README.md 记录了该模式的 statusline 徽章/caveman-commit→[CAVEMAN:COMMIT]mode tracker 还维护了一个.caveman-active.prev标志commit 这类独立模式是 one-shot 的它记住被顶替掉的原生话风模式下一个普通 prompt 到来时恢复且恢复逻辑按会话隔离——两个窗口各自运行/caveman-commit退出时各回各的话风等级。这与 SKILL.md 中 stop caveman-commit / normal mode 的退出条款在实现层面对应退出后 Agent 恢复常规verbose提交风格。实战使用方式在已安装 caveman 的 Claude Code 会话中暂存你要提交的改动git add由你执行——技能本身不 stage输入/caveman-commit或用自然语言触发write a commit、commit message、/commit 均在 frontmatter 声明的触发短语内Agent 按本文前述规则集产出 message 代码块复制粘贴后自行执行git commit并填入。需要退回详细提交风格时说 stop caveman-commit 或 normal mode 即可。技能的全部行为约束——规则集在 skills/caveman-commit/SKILL.md注册契约在 tests/installer/slash-commands.test.mjs模式解析在 src/hooks/caveman-parse.js——都在这三处可以复核。【免费下载链接】caveman why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman项目地址: https://gitcode.com/GitHub_Trending/caveman1/caveman创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 caveman caveman-commit：只写意图的 Conventional Commits 技能全解
caveman caveman-commit只写意图的 Conventional Commits 技能全解【免费下载链接】caveman why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman项目地址: https://gitcode.com/GitHub_Trending/caveman1/cavemancaveman-commit 是 caveman 仓库中专职生成提交信息的技能它把 Conventional Commits 规则压缩成一套“只写 why、不写 what”的最小规则集并以 slash 命令、自然语言短语两种入口驱动 Agent 产出即贴即用的 commit message。读完本文你将掌握该技能的完整规则体系subject/body/禁写清单、Auto-Clarity 强制场景、边界行为绝不代你执行git commit以及它在仓库中如何被注册为/caveman-commit命令、被 UserPromptSubmit hook 拦截并切换 commit 模式的完整链路。技能定位一条规则集不碰 git 状态技能的 canonical 定义位于 skills/caveman-commit/SKILL.md配套的人类可读说明在 skills/caveman-commit/README.md。SKILL.md 以 YAML frontmatter 声明身份与触发条件name: caveman-commit description: Write a Conventional Commits message compressed to intent only. Use for write a commit, commit message, /commit or /caveman-commit.frontmatter 之后的第一行是全部指令的纲领Write commit messages terse and exact. Conventional Commits format. No fluff. Why over what.即简洁、精确、Conventional Commits 格式、不灌水、意图优先于描述。技能在 docs/technical/skills-hooks-and-plugins.md 的能力总表中被登记为“Terse Conventional Commit message”并明确标注其边界Does not stage, commit, or amend不暂存、不提交、不 amend。Subject line 规则逐条完整继承SKILL.md 的 Rules 一节对 subject 行给出六条硬性约束是技能的核心产出契约格式type(scope): imperative summary其中scope可选type 白名单feat、fix、refactor、perf、docs、test、chore、build、ci、style、revert共 11 种祈使语气用 add、fix、remove禁止 added、adds、adding长度尽量 ≤50 字符硬上限 72 字符句尾不加句号冒号后的大小写跟随项目既有约定match project convention for capitalization after the colon。第 6 条值得注意技能并不强制某一种大小写风格而是要求先观察项目已有提交再对齐——这让生成的 message 在历史中不突兀。仓库为 Gemini CLI 准备的等价压缩版 prompt 同样内嵌了这些约束见 commands/caveman-commit.tomldescription Generate terse caveman-style commit message prompt Generate a terse commit message for the current staged changes. Conventional Commits format. Subject: ≤50 chars, imperative, lowercase after type. Body: only when why isnt obvious from subject. Why over what. No period on subject.注意 TOML 版的 prompt 把作用对象明确为current staged changes当前暂存改动与 SKILL.md 的 Boundaries 一节呼应技能只读暂存区来写 message绝不主动 stage。Body 规则默认不写四类情况必写Body 的默认策略是跳过Subject 自明时self-explanatory完全不加 body仅当存在以下四类内容时才添加 body非显然的whynon-obvious why、破坏性变更breaking changes、迁移说明migration notes、关联 issuelinked issuesbody 按 72 字符折行列表用-而不是*issue/PR 引用放在结尾格式为Closes #42、Refs #17。禁写清单这些内容永远不出现在 message 里SKILL.md 的 What NEVER goes in 一节定义了一条负面清单这是该技能与普通 commit message 生成器拉开差距的地方禁写内容替代方案This commit does X、I、we、now、currently删掉——diff 已经说明了 whatAs requested by ...使用Co-authored-bytrailerGenerated with Claude Code 或任何 AI 署名不加除非用户自己的规则要求Assisted-by/AI 署名 trailer此时以 trailer 形式追加Emoji不加除非项目约定要求复述 scope 已经表达过的文件名删掉scope 已承载该信息其中 AI 署名条款值得单独说明默认零署名但给用户规则留了后路——若用户项目规范本身要求 AI 署名则以 trailer 而非 body 叙述的形式出现避免污染意图正文。两个完整示例为什么比怎么写更重要SKILL.md 给出两段带 diff 语境的对照示例完整保留如下。示例一diff 是“新增用户 profile 端点且 body 解释 why”。❌ 反例feat: add a new endpoint to get user profile information from the database✅ 正例feat(api): add GET /users/:id/profile Mobile client needs profile data without the full user payload to reduce LTE bandwidth on cold-launch screens. Closes #128subject 只说“加了什么端点”body 回答“为什么要单独拆一个端点”移动端冷启动场景下省流量结尾挂 issue 引用。反例的问题在于它把 diff 里已经可见的 what 又复述了一遍。示例二diff 是破坏性 API 重命名。feat(api)!: rename /v1/orders to /v1/checkout BREAKING CHANGE: clients on /v1/orders must migrate to /v1/checkout before 2026-06-01. Old route returns 410 after that date.要点!标记破坏性变更BREAKING CHANGE:footer 给出迁移截止日和旧路由的失效行为410 Gone。Auto-Clarity四类变更禁止压缩成单行 subjectSKILL.md 的 Auto-Clarity 一节是一条覆盖性规则Always include body for: breaking changes, security fixes, data migrations, anything reverting a prior commit. Never compress these into subject-only — future debuggers need the context.即以下四类变更永远必须带 body不允许压成 subject-only破坏性变更breaking changes安全修复security fixes数据迁移data migrations对先前提交的回滚revert其理由写得很直白未来的排障者需要上下文。这与 Body 规则中“默认跳过”形成互补——常规改动享受极简高风险改动强制保留推理链。边界与退出只产出文本随时可退回详细模式SKILL.md 的 Boundaries 一节划定了技能的行为边界只生成 commit message不执行git commit、不 stage 文件、不 amend输出形态以代码块形式输出可直接复制粘贴退出机制说 stop caveman-commit 或 normal mode 即退回冗长verbose提交风格。README.md 对同一边界做了复述Outputs only the message. Does not stage, commit, or amend. 这意味着该技能可以安全地放进任何提交流程——它没有 git 副作用唯一产出物是待粘贴的文本。注册链路/caveman-commit如何恰好注册一次技能被声明为可由/caveman-commitslash 命令触发但“slash 命令能解析”本身在这个仓库里是被测试守护的契约。tests/installer/slash-commands.test.mjs 针对 issue #470 与 #571 断言每个对外文档化的命令都必须满足双通道注册Gemini 通道commands/name.toml必须存在Gemini CLI 扩展只读 TOML 命令——对应 commands/caveman-commit.tomlClaude Code 通道skills/name/SKILL.md或commands/name.md二者恰好其一。Claude Code 会把commands/*.md当作与skills/*/SKILL.md同一命名空间的扁平技能加载两者同时存在会让同一 slash 命令注册两次3 行 stub 与真正的规则集竞争测试注释中记录了claude plugin details曾列出重复项的现场。对caveman-commit而言Claude Code 侧的唯一提供方就是 skills/caveman-commit/SKILL.md测试中DOCUMENTED_COMMANDS白名单包含它保证这条命令在 Claude Code 里不会被解析成 Unknown command。另外从 skills/registry.json 的preserved_skill_ids列表含caveman-commit与 skills/compile.mjs 的校验逻辑看caveman-commit属于“保留技能”——它不进入编译器的skills数组不注入 native pack / CLI 生成物而是以独立的skills/caveman-commit/目录形式随插件分发由宿主Claude Code 等直接发现compile.mjs 在比对 canonical 技能目录时会显式豁免这些保留 id。这解释了为什么它没有出现在 registry 的skills数组里却仍然是可安装、可触发的正式技能。拦截与模式状态从输入框到[CAVEMAN:COMMIT]徽章输入/caveman-commit后仓库的 hook 链路会把它识别为一个“独立一次性模式”。关键证据在 src/hooks/caveman-parse.js// Modes handled by their own slash commands (/caveman-commit, etc.) — not // selectable via /caveman arg. const INDEPENDENT_MODES new Set([commit, review, compress]);commit是独立模式不能通过/caveman commit选择只能经由它自己的 slash 命令进入用户在自然语言路径误触时会被明确告知而非静默切换。解析主体在 src/hooks/caveman-parse.jsif (prompt.startsWith(/caveman)) { const parts prompt.split(/\s/); const cmd parts[0]; // /caveman, /caveman-commit, /caveman-review, etc. ... if (cmd /caveman-commit || cmd /caveman:caveman-commit) { return { action: set, mode: commit }; }注意它同时接受/caveman-commit与插件命名空间形式/caveman:caveman-commitmarketplace 插件安装下的呈现形态。模式判定后UserPromptSubmit hook src/hooks/caveman-mode-tracker.js 把commit写入模式标志文件src/hooks/README.md 记录了该模式的 statusline 徽章/caveman-commit→[CAVEMAN:COMMIT]mode tracker 还维护了一个.caveman-active.prev标志commit 这类独立模式是 one-shot 的它记住被顶替掉的原生话风模式下一个普通 prompt 到来时恢复且恢复逻辑按会话隔离——两个窗口各自运行/caveman-commit退出时各回各的话风等级。这与 SKILL.md 中 stop caveman-commit / normal mode 的退出条款在实现层面对应退出后 Agent 恢复常规verbose提交风格。实战使用方式在已安装 caveman 的 Claude Code 会话中暂存你要提交的改动git add由你执行——技能本身不 stage输入/caveman-commit或用自然语言触发write a commit、commit message、/commit 均在 frontmatter 声明的触发短语内Agent 按本文前述规则集产出 message 代码块复制粘贴后自行执行git commit并填入。需要退回详细提交风格时说 stop caveman-commit 或 normal mode 即可。技能的全部行为约束——规则集在 skills/caveman-commit/SKILL.md注册契约在 tests/installer/slash-commands.test.mjs模式解析在 src/hooks/caveman-parse.js——都在这三处可以复核。【免费下载链接】caveman why use many token when few token do trick — Claude Code skill that cuts 65% of tokens by talking like caveman项目地址: https://gitcode.com/GitHub_Trending/caveman1/caveman创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考