SuperAPI AI 工具集

commit-message

编程与开发

查看项目

更新于 10-25 04:21

技能介绍

用途:该技能用于自动为 Abacus 即将提交的变更生成规范的提交信息(commit message),包括主题行和正文。它由 Abacus 在 land.commit 阶段调用,而非人工直接编写提交信息。

输入信息:调用时 Abacus 会提供变更内容、bead 的标题、变更来源(所跟踪的 issue 或工单,可能为空),以及每条验收标准及其证据。

使用方式:调用 Skill(bitwarden-delivery-tools:committing-changes),并遵循其提交信息格式、type 关键字和正文规则。工单前缀的处理规则为:当 bead 的 source 是 Jira 工单(如 PM-1234 形式的键,或 bitwarden.atlassian.net/browse/ 链接)时,使用该键作为前缀,形如 [PM-1234];否则(GitHub issue、其他链接或无来源)完全去掉方括号,格式为 <type>: <imperative summary>,且不得编造工单键或写占位符。

格式要求:每条提交都使用完整格式。技能中针对分支首次提交之后的 followup-commit 豁免(短摘要、无前缀无正文)在此不适用;由于 Abacus 无人值守地落地变更,它生成的每条提交都带有工单前缀(当存在工单时)、type 关键字和正文,不论分支上之前有什么。

职责边界:该技能只撰写提交信息;Abacus 阶段负责记录,abacus-finalize 负责提交并追加 Abacus 自身的 trailer,因此技能输出中不应包含 trailer。技能中会产生实际动作的步骤应跳过:分支已由该阶段确定(属于 Abacus),pre-commit 检查已由门禁和审查者执行,暂存或提交属于 abacus-finalize。

适用范围与限制:不涉及 pull request 标题;PR 标题由 Abacus 的 land.pr 槽使用 bitwarden-delivery-tools:applying-pr-conventions 处理,在无工单时同样去掉方括号,以便同一 bead 的提交主题与 PR 标题保持一致。