# {{.Name}}

{{.Description}}

## 仓库结构

```text
skills/
└── README.md
```

后续技能放在 `skills/<skill-directory>/` 下，每个技能目录包含 `SKILL.md`，需要长背景资料时再添加 `references/`。`SKILL.md` frontmatter 的 `name` 是展示名称；目录名只作为路径安全的存放位置。

## 技能索引

当前模板不创建默认技能。添加、导入、删除或重命名技能后，同步维护这里的技能索引。

<!-- BEGIN agentteam skill index -->
| 技能 | 入口 | 用途 | 维护者 |
| --- | --- | --- | --- |
<!-- END agentteam skill index -->

## 维护边界

| 区域 | 谁维护 | 什么时候更新 |
| --- | --- | --- |
| `README.md` | 人工维护 | 技能增删、用途变化、索引或维护流程变化时更新。 |
| `AGENTS.md` | 人工维护 | 仓库级协作规则变化时更新。 |
| `skills/README.md` | 人工维护 | `skills/` 目录的放置规则变化时更新。 |
| `skills/<skill-directory>/SKILL.md` | 人工维护或外部导入 | 技能触发条件、执行步骤、输出格式变化时更新。 |
| `skills/<skill-directory>/references/` | 人工维护或外部导入 | 长文档、示例、背景材料变化时更新。 |

## 导入后的维护流程

1. 从 Skill detail 页导入外部内容；导入会替换 `skills/` 目录。
2. 检查 `skills/` 下每个 `SKILL.md` 的 frontmatter，确认 `name` 和 `description` 是稳定的触发语义。
3. 同步更新上面的技能索引：新增、删除、重命名技能时都要改索引。
4. 把长背景资料放入对应技能的 `references/`，并从该技能的 `SKILL.md` 链接过去。
5. 提交前查看 diff：如果只有技能内容变化，通常维护 `skills/`；如果目录结构或技能清单变化，也要维护本 README。

## 变更判断

- 只改某个技能的步骤：维护对应 `skills/<skill-directory>/SKILL.md`。
- 添加或删除技能：维护 `skills/` 和本 README 的技能索引。
- 添加参考资料：维护对应 `references/`，必要时在 `SKILL.md` 加链接。
- 改仓库协作规则：维护 `AGENTS.md`。