用途:为 adk-python 仓库生成符合规范的提交信息与 PR 描述。提交信息采用 Conventional Commits 格式 <type>(<scope>): <description>,type 决定变更在 CHANGELOG.md 中的归类:feat 归 Features,fix 归 Bug Fixes,perf 归 Performance Improvements,docs 归 Documentation,refactor、test、build、ci、style、chore 不生成条目;映射见 .github/release-please-config.json,未列出的 type 不产生变更日志。scope 可选,用简短模块名且不含下划线,如 fix(cli):、feat(a2a):、fix(sessions):。主题行应说明变更原因而非改动内容,使用祈使语气、冒号后首词小写、不加句尾句号、约 72 字符以内;issue 引用写在正文而非主题,如 Fixes #1234 或 Closes #1234。正文空一行后写简短具体说明,功能写新能力或用法,修复写失败原因与解决方式。提交前需运行 pre-commit:pre-commit install(每个克隆一次)、pre-commit run --files {paths};钩子含 isort、pyink、addlicense、mdformat、ruff、codespell 及仓库本地合规检查,见 .pre-commit-config.yaml;未安装 pre-commit 时应参考 adk-setup 技能。PR 除小型文档或拼写修正外需关联 issue,在描述中写 Closes: #{issue_number},并填写 .github/pull_request_template.md 的 Testing Plan,包含 pytest 通过结果摘要。不要在 GitHub 上合并,Do Not Merge on GitHub 检查对 main 的每个 PR 都会失败,由维护者落地并同步回仓库,GitHub 显示为 closed 加 merged 标签,落地提交保留原作者,该红色检查属预期。限制:资料未提供该技能的安装方式、收费、平台支持等细节。
adk-git
编程与开发
更新于 10-15 21:54