soia-meta-skill-releaselisted
Install: claude install-skill soia-team/soia-open-skills
# soia-meta-skill-release
在技能 PR 已 merge 后完成本机发布收尾:安装或更新变更技能、清理旧名、补全 Codex 链接、同步消费者目录,并用 lock 与版本进行独立对账。触发词:**「发布技能」**、**「发布 X」**、**「技能发布收尾」**、**「release skill」**。
## 客户可读说明
### 这个技能可以做什么
| 客户想要 | 技能会做 | 客户能看到 |
| --- | --- | --- |
| 发布 merge 后的一个或多个技能 | 安装、更新、软链同步并核对 lock/版本 | 六列发布回执 |
| 重命名或删除旧技能 | 移除旧安装与全部受管目录残留 | 已清理数量与零残留验证 |
### 客户如何使用
先确认目标技能已 merge 到远端仓库;本技能不执行 git、PR、merge、push 或发布远端状态。再提供仓库、技能名单和可选旧名:
```bash
python3 skills/soia-meta-skill-release/scripts/release_skills.py \
--repo <owner/name> \
--skills <skill-a,skill-b> \
--removed <legacy-skill> \
--dry-run
```
复核 dry-run 后,移除 `--dry-run` 执行。默认面向 `claude-code,codex`,可用 `--agents` 覆盖。版本核对按以下顺序解析本地 checkout:
1. `--repo-dir <repo-path>` 显式路径;
2. 当前进程的 `SOIA_SKILL_REPOS_ROOT/<repo-name>`;
3. 私有 YAML:`--config` → `SOIA_META_SKILL_RELEASE_CONFIG_FILE` → `~/.config/soia-skills/soia-meta-skill-release/config.yml` 中的 `env.SOIA_SKILL_REPOS_ROOT`;
4. v1 私有配置目录只读回退(会向 stderr 输出建议的 `mv` 迁移命令);
5. 旧版维护者本地目录约定,仅作弃用中的向后兼容回退。
仓库内部仍须采用 `skills/<skill-name>/SKILL.md` 布局。对未来新增仓库,只要 `--repo` 提供对应的任意 `<owner>/<repo-name>`,无需修改脚本。
### 依赖与安装
```bash
claude plugin marketplace add soia-team/soia-open-skills
```
```bash
claude plugin install soia-meta@soia
```
只要这一个技能时,可用 npx 路线。注意技能会落进共享真源 `~/.agents/skills`;若同时装了插件,同一技能会出现两份索引且各自漂移,建议二选一:
```bash
npx skills add soia-team/soia-open-skills -g -a '*' -s soia-meta-skill-release -y
```
| 依赖 | 类型 | 用途 | 缺失时怎么处理 |
| --- | --- | --- | --- |
| `npx skills` | 强依赖 | 安装、移除、更