CE Commit 提交助手
用清晰、传达价值的提交信息创建 Git 提交,让提交历史说明变更结果。
该技能明确限定为仅本地提交,明令禁止推送和PR,避免越权操作;要求只暂存指定文件,禁止使用git add -A或git add .,符合最小权限原则。技能中没有涉及敏感数据处理,也没有外部网络调用。但未明确声明用户确认步骤,尽管分支创建等操作可能由代理自动执行;发布者身份未经验证,且无回滚机制的描述。因此未达到满分。
指令内部一致,提供了清晰的上下文获取命令和失败解释表,对非零退出状态有明确处理说明。但缺少针对该技能关键路径的测试覆盖,例如没有直接验证ce-commit技能执行的测试。静态度量无法确认在Windows以外的环境完全可复现。因此可靠性评分低于10。
适用场景清晰:当用户要求提交更改时触发。边界明确:仅提交,不推送、不创建PR。但触发条件在复杂场景下可能不够精确,例如用户可能期望提交所有更改而技能会创建多个逻辑提交。环境适用性上,技能旨在跨平台支持,但未提及中国大陆网络可达性;该技能不依赖外部服务,因此不受影响。但缺少对非目标场景(如用户明确要求推送)的处理说明。
文档结构完整,有明确的名称、描述、使用场景、工作流和示例。附带README提供全面安装说明和变更日志链接。但未查看具体的变更日志文件,版本信息在package.json中可见,但技能本身无版本号。维护责任部分在SECURITY.md中提及联系方式,但未明确技能自身的更新路径。因此扣分。
技能能够完成提交任务,输出明确的提交消息。但缺少可验证的典型输出和实际执行的证据;静态度量无法确认其高效性。边际价值在于自动生成符合项目惯例的提交消息,但可能不如用户手动控制。因此低于7分。
仓库CI覆盖了多种转换器和插件验证,但未发现针对ce-commit技能的专门测试。技能中的示例和说明可审计,但缺乏独立复现证据。因此低于5分。
- 发布者身份未经验证,来源可信度待确认。
- 技能未明确要求用户确认,尤其是自动创建分支可能超出用户预期。
- 缺乏针对ce-commit技能自身的测试覆盖,无法证实其可靠性。
- 未提及中国大陆网络可达性,但该技能不依赖外部服务,影响有限。
- 变更日志文件未在提供材料中,版本历史不完整。
这个 Skill 能做什么,适合哪些场景?
这是 Compound Engineering 插件包中的一个技能,专注于本地 Git 提交。它帮助用户将工作区中的变更进行逻辑分组,并生成符合项目惯例的提交信息。通过收集仓库状态、检查分支和提交历史风格,它能够推导出合适的提交规范(如 conventional commits),并指导用户以单个文件、分组提交的方式安全地暂存和提交。该技能不推送、不创建 PR,仅处理本地提交。它强调在提交前检查工作区状态,避免在默认分支或分离 HEAD 上提交。
执行一系列 shell 命令(git status、git diff HEAD、git branch --show-current、git log --oneline -10、git rev-parse --abbrev-ref origin/HEAD)来收集仓库上下文;检查工作区是否干净;如果在默认分支或分离 HEAD,则创建特性分支;根据项目历史或 conventional commits 规范生成提交信息;仅按文件名暂存文件(不使用 git add -A 或 .);执行 git add 和 git commit;最后确认 git status 并报告提交哈希和主题。
- 软件开发者在完成一项功能或修复后,希望将更改以清晰、有意义的提交信息进行本地提交。
- 在大型代码库中工作时,希望将不同类型的更改(如修复和新功能)拆分为逻辑独立的提交。
- 开发者希望遵循项目现有的提交风格或 conventional commits 规范。
- 在默认分支或分离 HEAD 上工作时,需要先创建特性分支再提交。
- 用户希望通过避免 `git add -A` 等方式精确控制暂存的内容。
这个 Skill 有哪些优点和局限?
- 自动生成清晰、面向结果的提交信息。
- 鼓励将更改分解为多个逻辑提交。
- 自动处理在默认分支或分离 HEAD 上创建分支的情况。
- 不推送或创建 PR,适合本地工作流程。
- 仅提供文件级别的分组,不支持 `git add -p` 之类的部分暂存。
- 需要 shell 访问和 Git 命令,在某些环境中可能受限。
- 未在如聊天界面等不支持 shell 的平台上测试。
如何安装这个 Skill?
此技能作为 Compound Engineering 插件的一部分提供。安装方式取决于客户端:Claude Code 使用 /plugin marketplace add EveryInc/compound-engineering-plugin 和 /plugin install compound-engineering;Cursor 使用 /add-plugin compound-engineering;Codex CLI 使用 codex plugin marketplace add EveryInc/compound-engineering-plugin 和 codex plugin add compound-engineering@compound-engineering-plugin;其他如 Kimi、Cline、Grok 等也有对应的安装方法。完整步骤见 README。
如何使用这个 Skill?
在仓库中,向 AI 助手发出请求,例如『提交这些更改』或『git commit』。该技能会自动执行收集上下文的步骤,然后根据提示创建提交。如果不确定,它会询问或按照既定流程进行。