用途:livre 是一个自动化的 Git 提交流程,覆盖从提交到创建 Pull Request 的完整步骤,适合在功能分支上完成改动后一键提交与发起 PR。
主要能力与步骤:
- 安全检查:执行 git branch --show-current 获取当前分支;若在 main 上则拒绝运行,并要求用户先创建功能分支(会建议使用 /branche)。
- 与远端 main 同步:git fetch origin main;用 git log HEAD..origin/main --oneline 检查是否落后;若落后则 git merge origin/main;遇到合并冲突会展示给用户并协助解决后再继续。
- 暂存与提交:执行 git status(不使用 -uall)查看改动,git diff 和 git diff --staged 复查,git log --oneline -5 参考最近提交风格;只精确添加相关的新增/修改文件,不用 git add -A;不暂存含密钥的文件(如 .env、凭据等)。若提供 $ARGUMENTS 则作为提交信息;否则按 CLAUDE.md 约定撰写,使用 feat: 或 fix: 前缀,强调“为什么”而非“做了什么”,结尾加 Co-Authored-By: Claude,并用 HEREDOC 保证格式。
- 推送:git push -u origin HEAD 设置上游跟踪。
- 创建 PR:使用 gh pr create,标题少于 70 字符,正文包含 ## Résumé(1 至 3 条)与 ## Plan de test,用 HEREDOC 书写,最后将 PR 的 URL 返回给用户。
使用方式:作为技能/指令调用 /livre,可附加参数作为提交信息。
限制:不能在 main 分支上运行;需要 Git 与 gh CLI 环境;冲突需人工介入解决;含密钥文件不会被自动暂存。