---
name: sophclaw-skill-creator
description: 在 SophClaw 仓库中创建新 skill / 修改已有 skill / 为已有 skill 补全 design.md。当用户说"创建skill""新建skill""开发一个skill""帮我做一个skill""修改skill""补充design.md""补全设计文档"时使用。
---

# SophClaw Skill Creator

在 SophClaw 仓库中交互式创建或维护 skill。

## 定位 skills 目录

触发后，先确定 sophclaw-skills 仓库的 skills 目录位置：

```bash
# 检查常见路径
ls skills/ 2>/dev/null && echo "FOUND:skills/" || echo "NOT_FOUND:skills/"
ls sophclaw-skills/skills/ 2>/dev/null && echo "FOUND:sophclaw-skills/skills/" || echo "NOT_FOUND:sophclaw-skills/skills/"
```

- 如果 `skills/` 存在且有 skill.json 文件 → 说明用户直接打开了 `sophclaw-skills/` 作为 workspace root
- 如果 `sophclaw-skills/skills/` 存在 → 说明用户打开了上一级目录
- 都不存在 → 请用户提供 skills 目录的绝对路径，赋给 `<skills_dir>`

后续所有操作中，用 `<skills_dir>` 指代这个路径。以下路径中的 `<skills_dir>` 均需替换为实际路径。

## 路径选择

触发后先判断用户意图，分流到对应路径：

| 用户意图 | 关键词 | 走哪条路径 |
|---------|--------|-----------|
| 创建新 skill / 修改已有 skill | "创建skill""新建skill""开发skill""修改skill" | 路径 A |
| 为已有 skill 补全 design.md | "补充design.md""补全设计文档" | 路径 B |

- **路径 A（创建/修改 skill）**：需求对齐 → 方案对齐 → 生成代码。详见 [references/path-a-create.md](references/path-a-create.md)
- **路径 B（补全 design.md）**：阅读代码 → 逆向整理 → 逐节确认 → 写入文档。详见 [references/path-b-backfill.md](references/path-b-backfill.md)

确定路径后，**只读取对应路径的 reference 文件**，不要把另一条路径加载到上下文。

## 关键规范速查

以下为核心要点摘要，完整规范见 [references/skill-notes.md](references/skill-notes.md)。

- description = 功能 + 触发场景（LLM 匹配的唯一依据）
- 路径用 `{baseDir}/scripts/xxx.py`，不含 `src/`
- 用 `uv run` 启动 Python 脚本，不用 `python`
- 不提及其他 skill，保持独立性
- SKILL.md 只写用法，不写实现细节
- SKILL.md frontmatter 不含 `version` 字段（由 skill.json 管理）
- `store` 类型必须有中文 `displayName` 和 `description`
- pyproject.toml 的 `version` 与 skill.json 保持一致
- Python 兼容 3.8+，用 pathlib，文件 I/O 指定 encoding="utf-8"