用途:这是一个根据本地 Git 历史起草 Pull Request 标题与描述的技能,帮助开发者快速产出结构化的 PR 文案。
主要能力:脚本位于该技能目录下的 scripts/pr_writer.py,由 harness 解析路径。它可运行辅助脚本或检查分支,确定来源分支、目标分支、提交与改动文件;检测仓库 profile 或接受 --profile 参数;按 profile 生成包含 Description、Test Plan、Test Result、Links 等段落的草稿,前端 profile 额外加入 Screenshot。标题规则:feat 表示新增行为、fix 表示修复、refactor 表示重构;分支或提交中含工单时格式为 <feat|fix|refactor> [TICKET-123]: concise description,无工单时为 <feat|fix|refactor> (feature-name): concise description。所有论断须有本地上下文支撑,未知信息要标注而非编造。
使用方式:在用户仓库中运行 python3 <skill-dir>/scripts/pr_writer.py;命令示例为 draft --repo-dir . [--target main] [--format toon] [--profile frontend]。
Profile 判定信号:React、Next、Vue、Nuxt、Svelte、Angular、Astro、Preact、React Native,以及 Flutter 的 pubspec.yaml 归为 frontend;Dart 的 pubspec.yaml 归为 dart;go.mod 归为 go;无匹配则为 generic。
适用场景:需要为本地分支快速生成符合规范 PR 描述与标题的日常开发流程。
限制:完成标准要求标题符合工单规则、正文含适用标题、profile 匹配仓库、未知信息已标注;其余如具体配置、依赖与错误处理细节暂未提供。