用途:为当前分支(对比 main)撰写 PR 标题和描述,让评审者无需打开 diff 就能理解改动。
主要能力:生成符合 Conventional Commits 的标题(类型含 feat、fix、chore、refactor、perf、docs、test、build、ci、style、revert,可选 scope,无前导 emoji);描述回答 Why、How、What can break。写作前必须加载并使用全局 unslop 技能(~/.agents/skills/unslop/SKILL.md)。输出写入 Obsidian 库,按项目分组,路径为 <vault>/engineering/<project>/pull-requests/<timestamp>-<branch>.md,每次运行新建文件不覆盖,并更新项目与根索引。
使用方式:先并行检查分支(git rev-parse --abbrev-ref HEAD、git log main..HEAD --oneline、git diff main...HEAD --stat、git diff main...HEAD),若在 main 上则停止。按改动类型选一个原型(feat、perf、fix、refactor、docs)决定章节。从 diff 提取事实(端点、迁移、配置键、指标、行为变化)。库根为 $OBSIDIAN_AI_VAULT(默认 $HOME/Documents/obsidian/obsidian)。写完后交由 ai-commit 技能提交,提交信息为 ai-create-pr: <branch>,不直接运行 git add/commit/push。
限制:不得编造指标、配置、迁移或端点,只能引用 diff 中的内容;描述控制在约 250 词内;空章节删除;不使用填充词;不逐条列出所有改动文件。若 ai-commit 报告无暂存、无 origin 或推送失败,简要报告后结束。