القائمة
Use when 需要将代码变更推送到 GitHub、创建 PR、进行 code review、合并分支、使用 git worktree 隔离开发，或任何涉及 Git/GitHub 协作的操作。触发词：提交代码、push、PR、pull request、创建 PR、合并、merge、rebase、分支、branch、worktree、代码审查、code review、推送到远程、发起合入、审查这个 PR。不触发：纯本地只读查询（git log/git diff/git status/git branch -v 等不改变仓库状态的命令）。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | Github协作 |
| description | Use when 需要将代码变更推送到 GitHub、创建 PR、进行 code review、合并分支、使用 git worktree 隔离开发，或任何涉及 Git/GitHub 协作的操作。触发词：提交代码、push、PR、pull request、创建 PR、合并、merge、rebase、分支、branch、worktree、代码审查、code review、推送到远程、发起合入、审查这个 PR。不触发：纯本地只读查询（git log/git diff/git status/git branch -v 等不改变仓库状态的命令）。 |
| allowed-tools | ["Read","Write","Edit","AskUserQuestion","Agent","Glob","Grep","Bash","PowerShell","Skill"] |
代码编写链的收尾环节：代码写完后如何安全地提交、审查、合并到主分支。上游：智能体闭环开发（阶段4验证通过后调用，含 bug 修复路径）；PR 创建后使用 /code-review 或 gh pr review 审查。
1. 创建隔离环境（首选 worktree：主目录不受影响、每个 worktree 有独立 .claude/ 上下文、完成后可一键清理）：
git worktree add -b feature/<feature-name> ../<worktree-dir> origin/main
降级方案（worktree 不可用时）：
git checkout -b feature/<feature-name> origin/main
2. 确认就绪：分支从最新 main/master 创建；工作目录已切换到新分支；项目能正常构建/运行。
1. 自检清单（提交前逐项确认）：
git diff --stat 确认每个文件都是有意改的🚨 强制验证门禁：自检项全部勾选后必须调用「myworkflow:real-world-verify」执行真实验证。不通过 → 拒绝提交，先修复问题。此门禁不可跳过——即使改动"很小"也必须执行。若调用方（智能体闭环开发）已调用过且全部通过，可免重复调用，但须在自检中引用已有验证报告。
2. 提交策略：微小（单文件几行）→ 单个 commit；中等（多文件同主题）→ 单 commit 或 2-3 个逻辑分离的 commit（每 commit 做一件事）；大型（多功能跨模块）→ 多个可独立 review 的 commit，用 git add -p 精确控制。
3. commit message 格式：
<type>(<scope>): <subject> # 一句话概述，≤50 字符，中文
<body> # 做了什么、为什么；每行 ≤72 字符
type：feat 新功能 / fix Bug 修复 / refactor 重构（不改变行为）/ docs 文档 / test 测试 / chore 构建/工具/依赖。结尾加 Co-Authored-By: Claude <noreply@anthropic.com>。
4. 提交并推送（PowerShell 环境用 @'...'@ here-string 替代 bash heredoc）：
git add <files>
git commit -m @'...'@
git push -u origin feature/<feature-name>
1. PR 描述必须包含：
## 变更概述
[做了什么、为什么这样做]
## 变更文件
- `path/to/file` — [改了什么]
## 验证方式
- [ ] [验证步骤 + 结果]
## 回归风险
- [可能受影响的区域 + 是否已检查]
## 截图/录屏（如适用）
---
🤖 Generated with [Claude Code](https://claude.com/claude-code)
（可通过项目 CLAUDE.md 的 `pr-footer` 配置自定义或移除）
2. 创建 PR：
gh pr create --title "<type>: <简短描述>" --body @<pr-body-file> --base main --head feature/<feature-name>
常用 flag：--draft（标记还需改）/ --reviewer <username> / body 含 Closes #123 关联 issue / 不加 --body 则打开浏览器手填。
3. 确认就绪：PR 标题清晰；描述含验证方式与回归检查；CI 全部通过；CI 未过 → 修复后 git push 会自动更新 PR。
作为审查者：
gh pr checkout <N> / gh pr diff <N> / gh pr view <N>。/code-review 或手动按维度审查：正确性（逻辑/边界/错误处理）、安全性（注入/敏感数据/权限）、可维护性（命名/结构/注释）、变更范围（无无关改动/改动最小化）、测试覆盖（关键路径有测试）。gh pr review 不支持 -f 指定文件）；整体评论 gh pr review <N> --approve / --request-changes -b "..." / --comment -b "..."；复杂审查 gh pr view <N> --web。作为被审查者（遵循「myworkflow:anti-sycophancy」——验证后再改，不盲目接受）：
gh pr view <N> --comments。git add + commit + push，PR 自动更新，通知 reviewer 重新审查。1. 合入条件：至少 1 人审查通过（Approved）；CI 全部通过；所有 review 讨论已解决；无 merge conflict（有则先解决）。
2. 合并方式：默认 Squash merge（gh pr merge <N> --squash——main 保持干净，每个 PR 对应一个 commit），除非用户明确要求 Rebase merge（每个 commit 都有独立价值、保持线性历史，--rebase）或 Merge commit（保留分支痕迹，--merge）。
3. 执行合并：
gh pr merge <PR-NUMBER> --squash --delete-branch # --delete-branch 合并后删除远程分支
4. 清理本地：
git checkout main && git pull
git branch -d feature/<feature-name>
git worktree remove ../<worktree-dir> --force # 有未提交变更时；否则不加 --force
git worktree prune # 残留 worktree 引用清理
5. 确认清理完毕：git worktree list（只剩 main 工作目录）；git branch（开发分支已删除）。
git fetch origin && git checkout main && git pull
git checkout feature/<name> && git rebase origin/main
# 编辑冲突文件 → git add → git rebase --continue；放弃 rebase：git rebase --abort
git push --force-with-lease origin feature/<name> # rebase 后必须强制推送
gh pr close <PR-NUMBER> # 关闭 PR（不删除分支）
git revert -m 1 <merge-commit-SHA> && git push origin main # 撤销已合并的 PR
跳过完整 worktree 隔离流程，从 main 快速修复：
git checkout main && git pull && git checkout -b hotfix/<description>
git add <files> && git commit -m "fix: <紧急修复描述>" && git push -u origin hotfix/<description>
gh pr create --title "fix(urgent): <描述>" --base main
# 合并后清理同场景 E
场景 A：worktree 已创建（或分支从 main 切出）；工作目录已切换到新环境。
场景 B：自检清单全部通过；commit message 符合格式；已推送到远程分支。
场景 C：PR 描述完整（概述+文件+验证+回归）；gh pr create 成功；CI 通过。
场景 D：审查覆盖正确性/安全性/可维护性/变更范围/测试覆盖；审查意见已提交（approve/request-changes/comment）；收到反馈则逐条处理并 push。
场景 E：PR 已合并到 main；远程分支已删除；本地分支已删除；worktree 已清理（如使用）；已切回 main 并 pull 到最新。
Use when 需要以"少即是多"的方式思考与协作时触发——回答过长、方案过度设计、输出冗余、或需要克制时。触发词：少即是多、简洁一点、精简、less is more、别写太多、克制一点。本 skill 是行为准则，横切不绑定具体任务。
Use when 需要编辑或审阅文本，去除 AI 生成痕迹使其听起来更自然、更像人类书写。触发词：去 AI 味、润色文本、改写、humanize、去机器人味、太像 AI 写的。不触发：纯技术文档审阅、代码审查、文本翻译。
Extract content from scanned/image-based PDFs using OCR, then reconstruct formulas, equations, and technical notation into proper LaTeX using contextual reasoning. Use this skill whenever the user asks to: extract text from scanned PDFs, OCR a PDF, convert scanned textbook/document pages to Markdown, reconstruct formulas/symbols from OCR output, digitize a physical document containing equations, convert image-based PDF to Markdown with LaTeX, or process scanned technical/scientific content. Works with any language supported by Tesseract OCR.
Transform structured STEM content (textbooks, lectures, academic papers) into rigorous, accessible study guides — delivered as if a university lecturer is teaching a student from scratch (textbook mode) or a research mentor is walking a junior through a paper (paper mode). Use whenever the user asks to create study notes, distill textbook sections, make exam prep materials, read/explain a paper, or "提炼/整理/总结" course/paper content — for math, physics, computer science, engineering, and related disciplines. Each invocation processes ONE chapter or paper section as a self-contained lecture. The skill follows a "formal statement → plain-language explanation" paradigm: every definition, theorem, and notation is stated formally first, then immediately unpacked in plain language with physical intuition and step-by-step reasoning. Includes a mandatory self-review phase before output.