skill-manager

name	skill-manager
description	管理本地 agent-skills 仓库，并将其中的 skill 安装到各 Agent 工具目录。当用户要求更新、修改、创建、配置、安装、链接、建立符号链接、同步、提交或推送 ~/Documents/projects/agent-skills 中的 skill 时使用，尤其适用于 skill update、update this Skill、config skills、install skills for Codex、install skills for Claude Code，或确保 ~/.agents/skills、~/.codex/skills 与 ~/.claude/skills 指向该仓库等请求。

Skill 管理器

概述

使用此 skill 管理 agent-skills GitHub 仓库中的个人 skill，并让 Agents、Codex 和 Claude Code 能够使用同一套 skill。

除非用户要求使用其他语言，否则默认使用中文回复。

默认值

• 仓库：~/Documents/projects/agent-skills。
• Skill 源目录：~/Documents/projects/agent-skills/skills。
• Agent skill 目录：~/.agents/skills。
• Codex skill 目录：${CODEX_HOME:-~/.codex}/skills。
• Claude Code skill 目录：${CLAUDE_CONFIG_DIR:-~/.claude}/skills。
• 权限检查所期望的 GitHub 账号：xerrors。
• GitHub 代理回退地址：http://127.0.0.1:7890。

如果用户指定了其他仓库、skill 名称、分支或安装目录，遵循用户明确给出的目标。

请求路由

• 当用户要求更改 skill、为 skill 添加行为、修复 skill、提交 skill 更改或推送 skill 更新时，使用 更新 流程。
• 当用户要求安装 skill、配置 skill、创建符号链接、检查 Agent 工具能否发现 skill，或让 Agents/Codex/Claude Code 共享仓库中的 skill 时，使用 配置 流程。
• 如果请求同时包含两类操作，先执行更新，再执行配置。

更新

编辑 skill 前，先同步仓库：

git -C ~/Documents/projects/agent-skills pull --ff-only

如果拉取似乎卡住或超时，使用本地代理重试一次，但不要写入全局 Git 配置：

git -C ~/Documents/projects/agent-skills \
  -c http.proxy=http://127.0.0.1:7890 \
  -c https.proxy=http://127.0.0.1:7890 \
  pull --ff-only

如果 Git 报告身份验证或权限错误，在继续之前检查 GitHub CLI 账号：

gh auth status
gh api user --jq .login

如果登录账号不是 xerrors，在执行任何提交或推送前停止，并告诉用户当前使用的是哪个账号。请用户切换账号或重新认证。如果 gh 出现网络故障，使用以下命令重试：

HTTPS_PROXY=http://127.0.0.1:7890 gh auth status
HTTPS_PROXY=http://127.0.0.1:7890 gh api user --jq .login

编辑时：

• 先使用 git status --short --branch 检查当前工作树。
• 保留无关的未提交文件或未跟踪文件。不要还原、覆盖、暂存或提交不属于本次 skill 更新的更改。
• 编辑目标 skill 前，读取其现有 SKILL.md 以及其中直接引用的资源。
• 创建新 skill 时，在可用的情况下使用本地 skill creator 工作流。
• 保持 SKILL.md 简洁。frontmatter 的 description 中只放必要的触发信息，流程细节放在正文中。
• 如果 skill 面向用户的描述或默认提示已经过时，更新 agents/openai.yaml。

编辑完成后，如果存在验证器，则验证修改过的 skill：

python3 ~/.codex/skills/.system/skill-creator/scripts/quick_validate.py <skill-dir>

如果该路径不存在，在已知的 Codex skill 目录中搜索 quick_validate.py，并使用找到的第一个验证器。

提交或推送之前：

• 向用户展示修改过的文件及简短摘要。
• 请求用户明确确认是否提交并推送。
• 即使用户最初要求更新，也不要在未经确认的情况下提交或推送。
• 用户确认后，只暂存相关 skill 文件以及有意修改的仓库元数据。

使用聚焦的提交：

git -C ~/Documents/projects/agent-skills add <changed-skill-files>
git -C ~/Documents/projects/agent-skills commit -m "Update <skill-name> skill"
git -C ~/Documents/projects/agent-skills push

如果推送因网络超时失败，使用每条命令单独设置的 7890 代理重试一次。如果推送因身份验证失败，再次检查 gh 当前登录的是否为 xerrors。

配置

配置流程用于确保仓库中的 skill 能被所有受支持的本地 Agent 工具 skill 目录发现。

首先确定源 skill：

• 如果用户指定了某个 skill，使用 ~/Documents/projects/agent-skills/skills/<name>。
• 如果用户没有指定 skill 名称，只要求安装或配置“这些 skill”，则枚举 ~/Documents/projects/agent-skills/skills 下所有包含 SKILL.md 的目录。
• 不要为不包含 SKILL.md 的目录创建链接。

对每个源 skill，检查以下目标：

~/.agents/skills/<skill-name>
${CODEX_HOME:-~/.codex}/skills/<skill-name>
${CLAUDE_CONFIG_DIR:-~/.claude}/skills/<skill-name>

使用 mkdir -p 创建缺失的父目录。对于每个目标：

• 如果目标不存在，创建符号链接。
• 如果目标是符号链接，且解析后的路径就是源 skill 目录，则保持不变。
• 如果目标是符号链接，但解析后指向其他位置，未经用户确认不要替换。报告现有目标和期望的源目录。
• 如果目标是真实目录或文件，不要覆盖。报告冲突并询问用户如何处理。

对于 ~/.agents/skills 和 Codex，优先创建直接指向仓库源目录的链接：

ln -s ~/Documents/projects/agent-skills/skills/<skill-name> ~/.agents/skills/<skill-name>
ln -s ~/Documents/projects/agent-skills/skills/<skill-name> "${CODEX_HOME:-$HOME/.codex}/skills/<skill-name>"

对于 Claude Code，如果 ~/.agents/skills/<skill-name> 已存在，则遵循本地约定：只要解析后的路径仍指向仓库源目录，就让 Claude Code 链接到 Agents 目录中的入口。

ln -s ../../.agents/skills/<skill-name> "${CLAUDE_CONFIG_DIR:-$HOME/.claude}/skills/<skill-name>"

如果该相对链接无法正确解析，则改为创建直接指向仓库源目录的符号链接。

创建后验证链接：

ls -l ~/.agents/skills/<skill-name>
ls -l "${CODEX_HOME:-$HOME/.codex}/skills/<skill-name>"
ls -l "${CLAUDE_CONFIG_DIR:-$HOME/.claude}/skills/<skill-name>"
realpath ~/.agents/skills/<skill-name>
realpath "${CODEX_HOME:-$HOME/.codex}/skills/<skill-name>"
realpath "${CLAUDE_CONFIG_DIR:-$HOME/.claude}/skills/<skill-name>"

在最终回复中，报告哪些链接原本已存在、哪些链接已创建，以及哪些冲突仍需用户处理。