fix: preserve existing agent guide files during install

This commit is contained in:
zfc
2026-03-12 21:33:59 +08:00
parent c27b85193f
commit e16da89569
3 changed files with 197 additions and 9 deletions
+11 -4
View File
@@ -56,7 +56,7 @@ RequirementsDoc ──▶ PRD ──▶ FeatureSummary ──▶ DevelopmentPlan
## 安装 & 更新
一行命令搞定安装和更新。脚本会智能处理:新 skill 直接装,已有的对比更新,本地魔改自动备份。
一行命令搞定安装和更新。脚本会智能处理:新 skill 直接装,已有的对比更新,本地魔改自动备份;项目根目录的 `AGENTS.md` / `CLAUDE.md` 仅在缺失时生成,已存在则跳过
```bash
# Claude Code + Codex(推荐)
@@ -78,9 +78,9 @@ bash /tmp/install-skills.sh both
### 安装脚本行为
- `both` 模式:同时安装 `.codex/skills/``.claude/skills/`,并生成 `AGENTS.md` + `CLAUDE.md`
- `codex` 模式:安装到 `.codex/skills/`,并在项目根目录生成或更新 `AGENTS.md`
- `claude` 模式:安装到 `.claude/skills/`,并在项目根目录生成或更新 `CLAUDE.md`
- `both` 模式:同时安装 `.codex/skills/``.claude/skills/`,并生成缺失的 `AGENTS.md` + `CLAUDE.md`;已有则跳过
- `codex` 模式:安装到 `.codex/skills/`,并在项目根目录生成缺失的 `AGENTS.md`;已有则跳过
- `claude` 模式:安装到 `.claude/skills/`,并在项目根目录生成缺失的 `CLAUDE.md`;已有则跳过
- 如果传入自定义目标目录,脚本会优先安装 Codex 版 skills;目标路径包含 `.claude/skills` 时自动切到 Claude 版
### 推荐用法
@@ -98,6 +98,13 @@ bash /tmp/install-skills.sh both
| 本地魔改过 + 上游有更新 | 写入上游新版,本地版备份为 `SKILL.md.local.bak` |
| 本地和上游一致 | 跳过 |
项目根目录 guide 文件单独处理:
| 情况 | 处理方式 |
|------|---------|
| `AGENTS.md` / `CLAUDE.md` 不存在 | 从模板创建 |
| `AGENTS.md` / `CLAUDE.md` 已存在 | 跳过,保持原样 |
恢复本地版本:`mv SKILL.md.local.bak SKILL.md`
对比差异:`diff SKILL.md SKILL.md.local.bak`