feat(skills): make Codex the default install target

This commit is contained in:
2026-08-20 12:07:10 +09:30
parent ef0e9ca1f0
commit bb5e6be73e
7 changed files with 139 additions and 49 deletions
+10 -3
View File
@@ -1,6 +1,6 @@
# Skill Sync Guide
仓库中的插件是团队技能的发布源,本机 `~/.claude/skills/` 是安装目标。个人技能保留在
仓库中的插件是团队技能的发布源。默认安装目标是 Codex 的用户级标准目录 `~/.agents/skills/`。个人技能保留在
`skills-personal/` 或其他本机目录,不会进入公开 marketplace。
## 从仓库更新本机
@@ -11,6 +11,12 @@ git pull
./install-skills.sh
```
Claude Code 需要显式选择目标:
```bash
./install-skills.sh --agent claude
```
安装器会复制完整技能目录,包括 `SKILL.md``references/``scripts/``assets/`。它用内容摘要区分仓库升级和本地修改:
- 目标未修改时,版本升级会自动安装。
@@ -23,11 +29,12 @@ git pull
```bash
./install-skills.sh --list
./install-skills.sh --category dev
./install-skills.sh --exclude ai-proj-cicd-release
```
## 将本机技能发布到仓库
不要批量复制整个 `~/.claude/skills/`。系统技能、第三方托管技能、包含机器路径或凭据的技能不应发布。
不要批量复制整个 `~/.agents/skills/` 或其他 Agent 的安装目录。系统技能、第三方托管技能、包含机器路径或凭据的技能不应发布。
1. 选择确实属于本仓库、可供团队复用的技能。
2. 在对应 `skills-*/<name>-plugin/` 下放置 `.claude-plugin/plugin.json` 和完整 `skills/` 目录。
@@ -51,7 +58,7 @@ git pull
**本地修改被跳过怎么办?**
先比较仓库源和 `~/.claude/skills/<name>/`。保留本地修改时将其整理成插件变更;确认丢弃时再对该次安装使用 `--force`。
先比较仓库源和 `~/.agents/skills/<name>/`。保留本地修改时将其整理成插件变更;确认丢弃时再对该次安装使用 `--force`。Claude 目标改查 `~/.claude/skills/`。
**marketplace 没更新?**