[1.4.0] - 2025-06-12
2026/9/7 5:21:32 网站建设 项目流程

[1.4.0] - 2025-06-12

【免费下载链接】agent-skillsProduction-grade engineering skills for AI coding agents.项目地址: https://gitcode.com/GitHub_Trending/agentskill/agent-skills

Added

  • Bulk task import via CSV

Fixed

  • Timezone drift in recurring task due dates

Deprecated

  • GET /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-versioning

Claude 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),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询