重命名 SKILL

目标：重命名一个 SKILL（目录名 + name 字段 + 索引）

本质：重命名 = 删除旧条目 + 添加新条目

完成后：必须执行 SYNC_INDEX.md 同步索引

---

步骤

Step 1: 重命名目录

mv spec_stage_skill/{category}/old-name/ \
   spec_stage_skill/{category}/new-name/

Step 2: 更新 SKILL.md

修改 frontmatter 中的

name

字段：

---
name: new-name    # 改为新名称
description: ...
---

Step 3: 更新索引

执行 SYNC_INDEX.md：

1. 底层索引

   {category}/_INDEX.md

   ：

   # 删除旧行
   | old-name | ... | `old-name/SKILL.md` |
   
   # 添加新行
   | new-name | ... | `new-name/SKILL.md` |
   

2. 上层索引

   _INDEX_STAGE_*.md

   ：同样更新

3. 全局索引

   _INDEX_ALL.md

   ：同样更新

Step 4: 验证

执行 VALIDATE_SKILL_AND_INDEX.md 确认：

• 路径正确
• 无悬空引用

---

跨目录迁移

如果需要将 SKILL 从一个目录移到另一个（如

common/

→

requirements/

）：

Step 1: 移动目录

mv spec_stage_skill/common/my-skill/ \
   spec_stage_skill/requirements/my-skill/

Step 2: 更新旧位置索引

从

common/_INDEX.md

移除条目。

Step 3: 更新新位置索引

在

requirements/_INDEX.md

添加条目。

Step 4: 更新上层索引

• 从

  _INDEX_STAGE_2.md

  、

  _INDEX_STAGE_3.md

  移除（common 在多个 Stage）
• 添加到

  _INDEX_STAGE_1.md

  （requirements 只在 Stage 1）

Step 5: 验证

执行 VALIDATE_SKILL_AND_INDEX.md

---

检查清单

• 目录已重命名
• SKILL.md 的 name 字段已更新
• 底层索引已更新
• 上层索引已更新
• 全局索引已更新
• 执行 VALIDATE_SKILL_AND_INDEX.md

---

AI Coding Agent 命令

请帮我将 old-name 重命名为 new-name：

1. 重命名目录
2. 更新 SKILL.md 的 name 字段
3. 更新所有索引
4. 验证正确性

请帮我将 my-skill 从 common/ 迁移到 requirements/：

1. 移动目录
2. 更新旧位置索引
3. 更新新位置索引
4. 更新上层索引
5. 验证正确性