Menu
全局 skill 提交规范。告知 AI 全局 skills 目录通常是符号链接，如何自动定位实际 git 仓库并正确提交推送。触发词：skill 提交、提交 skill、skill commit、全局 skill、推送 skill、commit skill。
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | skill-commit |
| description | 全局 skill 提交规范。告知 AI 全局 skills 目录通常是符号链接，如何自动定位实际 git 仓库并正确提交推送。触发词：skill 提交、提交 skill、skill commit、全局 skill、推送 skill、commit skill。 |
全局 skills 目录（~/.claude/skills/）通常是符号链接，指向某个 git 仓库内的子目录。创建/修改 skill 文件可以直接在 ~/.claude/skills/<name>/ 下操作（符号链接透明），但 git 操作必须去实际仓库根目录执行。
本 skill 告诉 AI 如何自动发现这些路径，适配任意机器、任意 OS 的部署方式。
在提交任何 skill 改动前，AI 必须先探测以下信息：
# 1. 解析 ~/.claude/skills/ 的实际路径（穿透所有符号链接）
# Linux/macOS: readlink -f 或 realpath
# Windows Git Bash: 同样支持 readlink -f
SKILLS_REAL=$(readlink -f ~/.claude/skills 2>/dev/null || realpath ~/.claude/skills 2>/dev/null)
# 如果 ~/.claude/skills 不是符号链接，它自身可能就是 git 仓库
# 直接用这个路径
# 2. 找到包含此目录的 git 仓库根目录
REPO_ROOT=$(cd "$SKILLS_REAL" && git rev-parse --show-toplevel 2>/dev/null)
# 3. 计算 skills 在仓库内的相对子目录
SKILLS_SUBDIR=$(cd "$SKILLS_REAL" && git rev-parse --show-prefix 2>/dev/null)
# 例如输出: agents/skills/ 或 skills/ 或为空（skills 就在仓库根目录）
# 4. 确认远程和分支
cd "$REPO_ROOT"
git remote -v # 获取 remote 名称和 URL
git branch --show-current # 当前分支名
探测后必须向用户展示：
Skills 实际路径: /home/user/code/agent-skills-hook/agents/skills
Git 仓库根目录: /home/user/code/agent-skills-hook
Skills 子目录: agents/skills/
Remote: origin git@github.com:user/repo.git
分支: main
直接在 ~/.claude/skills/<skill-name>/ 下操作即可，符号链接会透传到实际仓库：
mkdir -p ~/.claude/skills/<skill-name>
# 编辑 ~/.claude/skills/<skill-name>/SKILL.md
必须在第一步探测到的 $REPO_ROOT 下执行 git 操作：
cd "$REPO_ROOT"
# 确认改动（相对路径从 $SKILLS_SUBDIR 开始）
git status
# 暂存
git add "${SKILLS_SUBDIR}<skill-name>/"
# 提交。优先检查仓库是否有自定义提交规范（CLAUDE.md / CONTRIBUTING.md），
# 没有则用 Conventional Commits
git commit -m "<message>"
cd "$REPO_ROOT"
git push origin <branch>
| 症状 | 处理 |
|---|---|
readlink -f 不识别 | 换 realpath，都不行则 ls -la ~/.claude/skills 手动看指向 |
~/.claude/skills 不是符号链接 | 它自身可能就是一个 git 仓库，直接用 git rev-parse --show-toplevel 在它里面执行 |
git rev-parse --show-toplevel 失败（不在 git 仓库中） | 沿目录树向上找 .git 目录，或检查 skills 是否通过其他方式部署（如直接拷贝） |
Skills 就在仓库根目录（$SKILLS_SUBDIR 为空） | git add <skill-name>/ 即可，不需要前缀 |
| 多个 remote | 用 git remote -v 确认 push 目标，通常是 origin |
readlink -f 和 realpath 都可用readlink 没有 -f，用 realpath（需 coreutils）或 python3 -c "import os; print(os.path.realpath('...'))"readlink -f 通常可用；如不行用 cygpath 或手动 ls -la 解析~ 展开：用 $HOME 或 ${HOME} 替代在当前会话里按已写好的实现计划顺序执行任务时使用
在已有规格或多步骤任务需求、且在动代码之前使用。若上游 ddev-pc-test 已产出测试用例，自动走 TDD 流程：先实现测试 demo 代码（红灯），再实现被测代码（绿灯），测试覆盖不到的部分直接开发。
文档审查技能。将文档审查任务派发给独立子代理，重点审查文档基于代码改动的合理性、说明正确性、前后一致性、错漏和逻辑谬误，以及 AI 实现过程中产生的决策记录（implementation-notes.md）。当用户需要审查技术文档、spec文档、设计文档、计划文档、API文档、README 或任何与代码改动相关的文档时使用。
代码修改场景下，spec 文档确认后，需要继续以图优先方式梳理结构体定义、数据流和流程时使用
在代码修改前需要编写 spec 文档且应优先用图表达边界、入口、流程和改动关系时使用（仅限代码改动场景，非项目级架构文档初始化）
在代码实现完成后、准备结束任务或进入发布前使用，用来核对代码实现是否与 spec 文档以及 detail 文档一致，并通过代码质量审查、清理、编码规范和注释审查后给出最终验收结论