[1.4.0] - 2025-06-12【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skillsAddedBulk task import via CSVFixedTimezone drift in recurring task due datesDeprecatedGET /v1/tasks/all— use the paginatedGET /v1/tasks(removal in 2.0)文档强调 changelog 条目应在**做出变更的同一变更中**写下来——影响还在新鲜时而不是发布时靠提交考古去重建。破坏性变更需要迁移说明与弃用窗口遵循 [deprecation-and-migration](https://link.gitcode.com/i/1e97938c22ef1335da5e1160677d0525) 技能而把发布真正送上线是 [shipping-and-launch](https://link.gitcode.com/i/74cb9b0004a4586aff7f36a43a398ecf) 技能的职责——本节提供的是喂给它的版本契约。 ## 常见借口与事实对照 技能用一张表直面开发者和代理最常出现的自我开脱这部分在 AI 辅助开发语境下尤其有价值因为它可以直接作为对代理输出的审查标准 | 借口 | 事实 | |---|---| | 等功能做完再提交 | 一个巨型提交无法审查、调试或回滚。每个切片单独提交。 | | 提交信息无所谓 | 信息就是文档。未来的你和未来的代理需要理解改了什么、为什么改。 | | 回头再 squash 掉 | Squash 会摧毁开发叙事。从一开始就保持干净的增量提交。 | | 分支有开销 | 短命分支零成本且能防止冲突的工作互相碰撞。问题出在长命分支——1–3 天内合并。 | | 这个变更回头再拆 | 大变更更难审查、部署风险更高、更难回滚。提交前拆而不是提交后。 | | 我不需要 .gitignore | 直到带着生产密钥的 .env 被提交。立刻配置。 | | 就是个小修复bump 个 patch | 检查消费者能观察到什么。他们依赖的行为变更就是 major无论 diff 多小。 | | changelog 就是 commit log | 提交是给你自己的changelog 是给消费者的、按影响整理的。从原始提交生成的 changelog 会埋没重点。 | | 发布时再写 changelog | 到那时影响只能靠记忆重建而一半内容已经丢失。条目随变更一起写。 | ## 红旗信号Red Flags 以下状态出现时应立即警觉 - 大块未提交变更不断累积 - 提交信息形如 fix、update、misc - 格式变更与行为变更混在一起 - 项目没有 .gitignore - 提交了 node_modules/、.env 或构建产物 - 与 main 显著分叉的长命分支 - 对共享分支 force-push - 破坏性变更被装在 minor 或 patch 版本号下发布 - 发布没有 tag或手工编辑的版本号与 tag 脱节 - 面向用户的发布没有 changelog 条目或 changelog 只是倒出来的提交信息。 ## 验证清单Verification 技能以两个可勾选的清单收尾可直接用作 CI 检查或代码审查的核对表。 **对每次提交** - [ ] 提交只做一件逻辑上完整的事 - [ ] 信息解释 why并遵循类型约定 - [ ] 提交前测试通过 - [ ] diff 中没有密钥 - [ ] 没有格式类变更混入行为变更 - [ ] .gitignore 覆盖标准排除项 **对每次发布任何有消费者的产物** - [ ] 版本提升与变更匹配breaking → major增量 → minor修复 → patch - [ ] 发布已打 tag且版本号从 tag 派生不与 tag 脱节 - [ ] changelog 有按影响分组、人类可读的条目对应该版本 ## 在 agent-skills 中的安装与使用方式 该技能是仓库 25 个技能之一当前仓库版本见 [plugin.json](https://link.gitcode.com/i/ac7e1a3b68f9c0b9500b7f54530608e0)为 0.6.9。按 [README.md](https://link.gitcode.com/i/ba83623b4ce760b0b5490b7197813b29) 的说明安装方式有两条路径 **通用一条命令skills CLI支持 70 代理** bash # 安装全部技能 npx skills add addyosmani/agent-skills # 或单独安装本技能 npx skills add addyosmani/agent-skills --skill git-workflow-and-versioningClaude Code 本地/开发模式git clone https://gitcode.com/GitHub_Trending/agentskill/agent-skills.git claude --plugin-dir /path/to/agent-skills【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考