用途:该技能用于生成高质量、可审查、易回滚的 Odoo 提交信息,适用于为 Odoo 代码撰写新提交信息、改写或改进已有提交信息、校验提交信息是否符合 Odoo 规则,以及选择正确的 Odoo 标签。
主要能力:按 [TAG] module: short summary 结构输出,标题理想小于 50 字符,正文按 72 字符换行;仅使用英文;标题使用祈使语气(Fix、Remove、Add),拒绝 bugfix 等泛化词;正文优先说明 WHY 而非 WHAT;引用信息(task-、ticket-、Fixes #、Closes #、opw-*)置于末尾;支持 [NO CI] 等 CI 指令。标签需大写、加方括号、每个标题仅一个,可选 [FIX]、[REF]、[ADD]、[REM]、[REV]、[MOV]、[REL]、[IMP]、[MERGE]、[CLA]、[I18N]、[PERF]、[CLN]、[LINT]、[MIG];[MIG] 仅在项目约定支持时使用。模块名使用技术名而非营销名,多模块可用 various。
使用方式:起草前需收集模块名、变更意图、WHY 理由及引用信息;缺失时仅追问最少必要问题。若用户提供草稿,返回符合 Odoo 规范的修正版。用于 IDE 源代码管理时,返回可直接插入提交框的纯文本,无前言、标签或 Markdown。生成后可主动提出代为执行提交,但必须获得用户明确确认;安全执行方式为将完整提交信息写入临时文件并运行 git commit --file=<tmpfile>,随后删除临时文件,禁止将用户文本插入 -m 参数。
适用场景:Odoo 模块开发中的提交信息规范化、代码审查前校验、标签选择决策、迁移提交撰写。
限制:仅处理提交信息文本,不涉及代码逻辑;[MIG] 依赖项目约定;若标题未以大写方括号标签开头则必须重写;拒绝缺少模块名、缺少理由、过去时或第三人称、多主题混杂、标题被省略号截断的信息。本地参考文件 references/git_guidelines.md 与 references/CONTRIBUTING.md 仅用于边缘决策或政策依据。