sophhub 0.4.31 → 0.4.33

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "sophhub",
-  "version": "0.4.31",
+  "version": "0.4.33",
   "description": "SophHub CLI - Manage and download AI Agent skills and agents",
   "type": "module",
   "bin": {

package/skills/sophclaw-skill-creator/skill.json

@@ -1,10 +1,21 @@
 {
   "name": "sophclaw-skill-creator",
-  "version": "1.0.0",
-  "types": ["store"],
+  "version": "1.1.0",
+  "types": ["private"],
   "displayName": "Skill 创建向导",
-  "description": "在 SophClaw 仓库中交互式创建符合规范的 Skill，三步流程：需求对齐→方案对齐→生成代码",
+  "description": "在 SophClaw 仓库中创建/修改 Skill 或为已有 Skill 补全 design.md。两条路径：路径 A（创建/修改）三步流程：需求对齐→方案对齐→生成代码；路径 B（补全 design.md）五步流程：确定目标→阅读代码→逆向整理→逐节确认→写入文档",
   "changelog": [
+    {
+      "version": "1.1.0",
+      "date": "2026-05-28",
+      "changes": [
+        "新增路径 B：为已有 skill 补全 design.md（五步流程：确定目标→阅读代码→逆向整理→逐节确认→写入文档）",
+        "SKILL.md 拆分为入口+分流，路径 A/B 详细步骤拆分到 references/path-a-create.md 和 references/path-b-backfill.md",
+        "新增 <skills_dir> 自动定位机制，支持 workspace root 为 sophclaw-skills/ 或上级目录",
+        "路径 A 新增复用检查步骤：遍历已有 skill 发现可复用代码",
+        "generate.py 新增 --output-dir 参数，支持指定输出目录"
+      ]
+    },
     {
       "version": "1.0.0",
       "date": "2026-05-25",
@@ -14,5 +25,5 @@
     }
   ],
   "createdAt": "2026-05-25",
-  "updatedAt": "2026-05-25"
+  "updatedAt": "2026-05-28"
 }

package/skills/sophclaw-skill-creator/src/SKILL.md

@@ -1,205 +1,41 @@
 ---
 name: sophclaw-skill-creator
-description: 在 SophClaw 仓库中创建新 skill。当用户说"创建skill""新建skill""开发一个skill""帮我做一个skill"时使用。三步流程：需求对齐→方案对齐→生成代码。
+description: 在 SophClaw 仓库中创建新 skill / 修改已有 skill / 为已有 skill 补全 design.md。当用户说"创建skill""新建skill""开发一个skill""帮我做一个skill""修改skill""补充design.md""补全设计文档"时使用。
 ---
 
 # SophClaw Skill Creator
 
-在 SophClaw 仓库中交互式创建符合规范的 skill。
+在 SophClaw 仓库中交互式创建或维护 skill。
 
-## 流程
+## 定位 skills 目录
 
-```dot
-digraph skill_create {
-    rankdir=TB;
-
-    start [label="用户请求创建 skill", shape=oval];
-    step1 [label="第一步：需求对齐\n自适应提问，明确需求", shape=box];
-    spec1 [label="产出 design.md「需求说明」", shape=box];
-    user_ok1 [label="用户确认？", shape=diamond];
-    step2 [label="第二步：方案对齐\n设计结构 + 打磨 description", shape=box];
-    spec2 [label="产出 design.md「方案设计」+「测试用例」", shape=box];
-    user_ok2 [label="用户确认？", shape=diamond];
-    step3 [label="第三步：生成代码\ngenerate.py 生成骨架", shape=box];
-    edit [label="用户编辑 SKILL.md", shape=box];
-    validate [label="validate.py 校验", shape=box];
-    check [label="有 ERROR？", shape=diamond];
-    done [label="完成 ✅", shape=oval];
-
-    start -> step1;
-    step1 -> spec1;
-    spec1 -> user_ok1;
-    user_ok1 -> step1 [label="否，修改"];
-    user_ok1 -> step2 [label="是"];
-    step2 -> spec2;
-    spec2 -> user_ok2;
-    user_ok2 -> step2 [label="否，修改"];
-    user_ok2 -> step3 [label="是"];
-    step3 -> edit;
-    edit -> validate;
-    validate -> check;
-    check -> edit [label="是，修复"];
-    check -> done [label="否"];
-}
-```
-
-## 第一步：需求对齐
-
-自适应提问，帮用户把 skill 想清楚。每次只问一个问题，多问"为什么"。至少覆盖：
-
-1. **功能**：这个 skill 做什么？输入是什么？输出是什么？
-2. **触发场景**：用户会怎么说话来触发它？（这是 description 的核心素材）
-3. **上线平台**：确定 type，按以下决策树选择：
-
-```dot
-digraph type_select {
-    rankdir=TB;
-
-    q1 [label="用户能自己安装？", shape=diamond];
-    q2 [label="默认所有用户可见？", shape=diamond];
-    q3 [label="已确定长期维护？", shape=diamond];
-
-    store [label="store\n商店可安装\n需中文 displayName/description", shape=box];
-    builtin [label="builtin\n系统内置，默认可用", shape=box];
-    private [label="private\n内部使用，CLI 不可见", shape=box];
-    tmp [label="tmp\n临时/未分类，CLI 不可见", shape=box];
-
-    q1 -> q2 [label="否"];
-    q1 -> store [label="是"];
-    q2 -> builtin [label="是"];
-    q2 -> q3 [label="否"];
-    q3 -> private [label="是"];
-    q3 -> tmp [label="否/不确定"];
-}
-```
-
-- `store`：**必须**有中文 displayName 和 description
-- `private` / `tmp`：CLI list/download 不可见
-4. **是否需要脚本**：涉及 API 调用？复杂数据处理？还是纯指令型的 SKILL.md 就够？
-5. **是否需要 references/assets**：有大量参考文档？有模板文件？
-
-确认需求后，产出 `design.md` 的「需求说明」部分，格式：
-
-```markdown
-# <skill-name> 设计文档
-
-## 一、需求说明
-- 功能描述
-- 触发场景（用户怎么说话会触发）
-- 输入/输出约定
-- 上线平台及 type 选择理由
-```
-
-用户确认后进入下一步。
-
-## 第二步：方案对齐
-
-基于需求，设计 skill 结构。重点：
-
-### 目录结构设计
-
-讨论并确定需要哪些资源目录（scripts/references/assets），产出目录树。
-
-### description 打磨（核心）
-
-这是最容易出问题的地方。**description 是 LLM 匹配 skill 的唯一依据**，必须包含功能+触发场景。
-
-**公式**：`功能 + 触发场景 = 好的 description`
-
-正例：
-```yaml
-description: 压缩 PNG/JPEG 图片。当用户要求压缩图片、减小图片体积、优化图片大小时使用。
-```
-
-反例：
-```yaml
-# ❌ 太长，没有触发场景
-description: 这是一个功能强大的图片处理工具，支持多种格式的压缩、旋转、裁剪、滤镜等操作
-
-# ❌ 只写了功能，没写何时触发
-description: 图片压缩工具
-
-# ❌ 写了实现细节
-description: 使用 Pillow 库对图片进行有损压缩，支持调整质量和尺寸
-```
-
-**与用户协作打磨**：如果用户给的 description 太长或缺少触发场景，指出问题并帮助精简。
-
-### 方案产出
-
-在 `design.md` 中追加「方案设计」和「测试用例」：
-
-```markdown
-## 二、方案设计
-- 目录结构
-- 是否需要脚本及理由
-- SKILL.md 关键设计决策
-- 注意事项
-
-## 三、测试用例
-| 编号 | 测试场景 | 触发语句 | 预期匹配 | 预期行为 | 预期输出 |
-```
-
-测试用例至少覆盖：正常场景、不触发场景、边界场景。
-
-用户确认后进入下一步。
-
-## 第三步：生成代码
-
-### 生成骨架
+触发后，先确定 sophclaw-skills 仓库的 skills 目录位置：
 
 ```bash
-uv run {baseDir}/scripts/generate.py \
-  --name <skill-name> \
-  --type <builtin|store|private|tmp> \
-  --display-name <中文名称> \
-  --skill-description <中文描述> \
-  --resources scripts,references,assets
+# 检查常见路径
+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/"
 ```
 
-- `--display-name` 和 `--skill-description`：store 类型必填
-- `--resources`：可选，逗号分隔，按需创建
+- 如果 `skills/` 存在且有 skill.json 文件 → 说明用户直接打开了 `sophclaw-skills/` 作为 workspace root
+- 如果 `sophclaw-skills/skills/` 存在 → 说明用户打开了上一级目录
+- 都不存在 → 请用户提供 skills 目录的绝对路径，赋给 `<skills_dir>`
 
-### 用户编辑
+后续所有操作中，用 `<skills_dir>` 指代这个路径。以下路径中的 `<skills_dir>` 均需替换为实际路径。
 
-生成后提醒用户编辑 `src/SKILL.md` 填充具体内容。编辑注意事项：
-- description 已在第二步打磨好，直接填入 frontmatter
-- 路径用 `{baseDir}/scripts/xxx.py`（不含 `src/`）
-- 命令示范用 `uv run`，不用 `python`
-- 不提及其他 skill
-- 不写实现细节
+## 路径选择
 
-### 校验
+触发后先判断用户意图，分流到对应路径：
 
-```bash
-uv run {baseDir}/scripts/validate.py skills/<skill-name>
-```
-
-```dot
-digraph validate_loop {
-    rankdir=TB;
-
-    run [label="运行 validate.py", shape=box];
-    has_err [label="有 ERROR？", shape=diamond];
-    has_warn [label="有 WARNING？", shape=diamond];
-    fix_err [label="修复 ERROR（必须）", shape=box];
-    review [label="审视 WARNING\n决定是否修改", shape=box];
-    done [label="通过 ✅", shape=oval];
-
-    run -> has_err;
-    has_err -> fix_err [label="是"];
-    fix_err -> run [label="重新校验"];
-    has_err -> has_warn [label="否"];
-    has_warn -> review [label="是"];
-    review -> run [label="修改后重新校验"];
-    has_warn -> done [label="否"];
-}
-```
+| 用户意图 | 关键词 | 走哪条路径 |
+|---------|--------|-----------|
+| 创建新 skill / 修改已有 skill | "创建skill""新建skill""开发skill""修改skill" | 路径 A |
+| 为已有 skill 补全 design.md | "补充design.md""补全设计文档" | 路径 B |
 
-- **ERROR**：结构问题，必须修复（skill.json 缺失、name 不一致、store 缺少中文名等）
-- **WARNING**：内容建议，建议审视修改（description 偏长、路径含 src/、用了 python 而非 uv run 等）
+- **路径 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)
 
-STATUS=succeeded 当且仅当无 ERROR。
+确定路径后，**只读取对应路径的 reference 文件**，不要把另一条路径加载到上下文。
 
 ## 关键规范速查
 

package/skills/sophclaw-skill-creator/src/pyproject.toml

@@ -1,5 +1,5 @@
 [project]
 name = "sophclaw-skill-creator"
-version = "1.0.0"
+version = "1.1.0"
 description = "Interactive skill creation wizard for SophClaw repository"
 requires-python = ">=3.8"

package/skills/sophclaw-skill-creator/src/references/path-a-create.md

@@ -0,0 +1,208 @@
+# SophClaw Skill Creator — 路径 A：创建新 skill / 修改已有 skill
+
+适用于 skill 不存在或需要改动 skill 本身（代码、配置、SKILL.md）。
+
+三步流程：需求对齐 → 方案对齐 → 生成代码。
+
+```dot
+digraph skill_create {
+    rankdir=TB;
+
+    start [label="用户请求创建/修改 skill", shape=oval];
+    step1 [label="第一步：需求对齐\n自适应提问，明确需求", shape=box];
+    spec1 [label="产出 design.md「需求说明」", shape=box];
+    user_ok1 [label="用户确认？", shape=diamond];
+    step2 [label="第二步：方案对齐\n设计结构 + 打磨 description", shape=box];
+    spec2 [label="产出 design.md「方案设计」+「测试用例」", shape=box];
+    user_ok2 [label="用户确认？", shape=diamond];
+    step3 [label="第三步：生成代码\ngenerate.py 生成骨架", shape=box];
+    edit [label="用户编辑 SKILL.md", shape=box];
+    validate [label="validate.py 校验", shape=box];
+    check [label="有 ERROR？", shape=diamond];
+    done [label="完成 ✅", shape=oval];
+
+    start -> step1;
+    step1 -> spec1;
+    spec1 -> user_ok1;
+    user_ok1 -> step1 [label="否，修改"];
+    user_ok1 -> step2 [label="是"];
+    step2 -> spec2;
+    spec2 -> user_ok2;
+    user_ok2 -> step2 [label="否，修改"];
+    user_ok2 -> step3 [label="是"];
+    step3 -> edit;
+    edit -> validate;
+    validate -> check;
+    check -> edit [label="是，修复"];
+    check -> done [label="否"];
+}
+```
+
+## 第一步：需求对齐
+
+自适应提问，帮用户把 skill 想清楚。每次只问一个问题，多问"为什么"。至少覆盖：
+
+1. **功能**：这个 skill 做什么？输入是什么？输出是什么？
+2. **触发场景**：用户会怎么说话来触发它？（这是 description 的核心素材）
+3. **上线平台**：确定 type，按以下决策树选择：
+
+```dot
+digraph type_select {
+    rankdir=TB;
+
+    q1 [label="用户能自己安装？", shape=diamond];
+    q2 [label="默认所有用户可见？", shape=diamond];
+    q3 [label="已确定长期维护？", shape=diamond];
+
+    store [label="store\n商店可安装\n需中文 displayName/description", shape=box];
+    builtin [label="builtin\n系统内置，默认可用", shape=box];
+    private [label="private\n内部使用，CLI 不可见", shape=box];
+    tmp [label="tmp\n临时/未分类，CLI 不可见", shape=box];
+
+    q1 -> q2 [label="否"];
+    q1 -> store [label="是"];
+    q2 -> builtin [label="是"];
+    q2 -> q3 [label="否"];
+    q3 -> private [label="是"];
+    q3 -> tmp [label="否/不确定"];
+}
+```
+
+- `store`：**必须**有中文 displayName 和 description
+- `private` / `tmp`：CLI list/download 不可见
+4. **是否需要脚本**：涉及 API 调用？复杂数据处理？还是纯指令型的 SKILL.md 就够？
+5. **是否需要 references/assets**：有大量参考文档？有模板文件？
+
+确认需求后，产出 `design.md` 的「需求说明」部分，格式：
+
+```markdown
+# <skill-name> 设计文档
+
+## 一、需求说明
+- 功能描述
+- 触发场景（用户怎么说话会触发）
+- 输入/输出约定
+- 上线平台及 type 选择理由
+```
+
+用户确认后进入下一步。
+
+## 第二步：方案对齐
+
+基于需求，设计 skill 结构。重点：
+
+### 复用检查（先做，避免重复造轮子）
+
+在讨论具体方案之前，先检查已有 skill 是否有可复用的代码或模式：
+
+1. **完整读取已有 skill**：遍历 `<skills_dir>/` 下所有子目录，读取每个 skill 的全部文件（skill.json、SKILL.md、scripts/ 下的脚本）
+2. **判断复用价值**：根据第一步确认的需求，找出哪些 skill 的代码或设计模式可以复用（如 API 调用封装、输出格式、错误处理、目录结构等）
+3. **向用户呈现**：列出可复用的 skill 及具体复用点，问用户是否采纳
+
+> **为什么先做复用检查？** 仓库里已有数十个 skill，很多基础能力已有成熟的实现。直接复用可以减少代码量、保持风格一致、避免引入新的 bug 模式。
+
+### 目录结构设计
+
+讨论并确定需要哪些资源目录（scripts/references/assets），产出目录树。
+
+### description 打磨（核心）
+
+这是最容易出问题的地方。**description 是 LLM 匹配 skill 的唯一依据**，必须包含功能+触发场景。
+
+**公式**：`功能 + 触发场景 = 好的 description`
+
+正例：
+```yaml
+description: 压缩 PNG/JPEG 图片。当用户要求压缩图片、减小图片体积、优化图片大小时使用。
+```
+
+反例：
+```yaml
+# ❌ 太长，没有触发场景
+description: 这是一个功能强大的图片处理工具，支持多种格式的压缩、旋转、裁剪、滤镜等操作
+
+# ❌ 只写了功能，没写何时触发
+description: 图片压缩工具
+
+# ❌ 写了实现细节
+description: 使用 Pillow 库对图片进行有损压缩，支持调整质量和尺寸
+```
+
+**与用户协作打磨**：如果用户给的 description 太长或缺少触发场景，指出问题并帮助精简。
+
+### 方案产出
+
+在 `design.md` 中追加「方案设计」和「测试用例」：
+
+```markdown
+## 二、方案设计
+- 目录结构
+- 是否需要脚本及理由
+- SKILL.md 关键设计决策
+- 注意事项
+
+## 三、测试用例
+| 编号 | 测试场景 | 触发语句 | 预期匹配 | 预期行为 | 预期输出 |
+```
+
+测试用例至少覆盖：正常场景、不触发场景、边界场景。
+
+用户确认后进入下一步。
+
+## 第三步：生成代码
+
+### 生成骨架
+
+```bash
+uv run {baseDir}/scripts/generate.py \
+  --name <skill-name> \
+  --type <builtin|store|private|tmp> \
+  --display-name <中文名称> \
+  --skill-description <中文描述> \
+  --resources scripts,references,assets \
+  --output-dir <skills_dir>
+```
+
+- `--display-name` 和 `--skill-description`：store 类型必填
+- `--resources`：可选，逗号分隔，按需创建
+
+### 用户编辑
+
+生成后提醒用户编辑 `src/SKILL.md` 填充具体内容。编辑注意事项：
+- description 已在第二步打磨好，直接填入 frontmatter
+- 路径用 `{baseDir}/scripts/xxx.py`（不含 `src/`）
+- 命令示范用 `uv run`，不用 `python`
+- 不提及其他 skill
+- 不写实现细节
+
+### 校验
+
+```bash
+uv run {baseDir}/scripts/validate.py <skills_dir>/<skill-name>
+```
+
+```dot
+digraph validate_loop {
+    rankdir=TB;
+
+    run [label="运行 validate.py", shape=box];
+    has_err [label="有 ERROR？", shape=diamond];
+    has_warn [label="有 WARNING？", shape=diamond];
+    fix_err [label="修复 ERROR（必须）", shape=box];
+    review [label="审视 WARNING\n决定是否修改", shape=box];
+    done [label="通过 ✅", shape=oval];
+
+    run -> has_err;
+    has_err -> fix_err [label="是"];
+    fix_err -> run [label="重新校验"];
+    has_err -> has_warn [label="否"];
+    has_warn -> review [label="是"];
+    review -> run [label="修改后重新校验"];
+    has_warn -> done [label="否"];
+}
+```
+
+- **ERROR**：结构问题，必须修复（skill.json 缺失、name 不一致、store 缺少中文名等）
+- **WARNING**：内容建议，建议审视修改（description 偏长、路径含 src/、用了 python 而非 uv run 等）
+
+STATUS=succeeded 当且仅当无 ERROR。

package/skills/sophclaw-skill-creator/src/references/path-b-backfill.md

@@ -0,0 +1,111 @@
+# SophClaw Skill Creator — 路径 B：补全 design.md
+
+从已有代码逆向分析，为缺少 `design.md` 的 skill 补全设计文档。
+
+流程：逆向分析 → 对齐确认 → 生成文档。
+
+```dot
+digraph design_backfill {
+    rankdir=TB;
+
+    start [label="用户要求补全 design.md", shape=oval];
+    identify [label="第一步：确定目标 skill\n确认 skill 名称", shape=box];
+    read [label="第二步：阅读已有代码\nskill.json + SKILL.md + 脚本 + 资源", shape=box];
+    draft [label="第三步：逆向整理\n从代码中还原需求和方案", shape=box];
+    discuss [label="第四步：逐节确认\n与用户对齐理解", shape=box];
+    write [label="第五步：写入 design.md", shape=box];
+    done [label="完成 ✅", shape=oval];
+
+    start -> identify;
+    identify -> read;
+    read -> draft;
+    draft -> discuss;
+    discuss -> draft [label="用户纠正/补充"];
+    discuss -> write [label="用户确认"];
+    write -> done;
+}
+```
+
+## 第一步：确定目标 skill
+
+用户可能说"给 restore-state 补一个 design.md"、"补充 XXX 的设计文档"。先确认：
+
+1. skill 名称是什么？
+2. 确认路径 `<skills_dir>/<name>/` 存在（用 `ls <skills_dir>/<name>/` 验证）
+3. 确认 `design.md` 确实不存在（不覆盖已有文件）
+
+## 第二步：阅读已有代码
+
+完整读取目标 skill 的以下文件：
+
+| 文件 | 获取什么信息 |
+|------|-------------|
+| `<skills_dir>/<name>/skill.json` | name、version、types、displayName、description、changelog |
+| `<skills_dir>/<name>/src/SKILL.md` | 触发描述、前置检查、用法、输出格式、异常处理 |
+| `<skills_dir>/<name>/src/scripts/*.py` | 核心逻辑、关键设计决策、配置常量 |
+| `<skills_dir>/<name>/src/pyproject.toml` | 依赖、Python 版本要求 |
+| `<skills_dir>/<name>/src/references/*` | 参考文档 |
+| `<skills_dir>/<name>/src/assets/*` | 模板/资源文件 |
+
+**这一步不问用户任何问题**，全靠阅读代码收集信息。
+
+## 第三步：逆向整理
+
+从代码中还原设计文档所需的内容：
+
+**还原需求说明**（从 skill.json + SKILL.md）：
+- 功能描述 ← SKILL.md 的功能说明
+- 触发场景 ← SKILL.md 的 description + 触发条件描述
+- 输入/输出约定 ← SKILL.md 的输入输出描述 + 脚本的 exit code 逻辑
+
+**还原方案设计**（从脚本代码 + 目录结构）：
+- 目录结构 ← `ls` 查看实际文件树
+- 是否需要脚本及理由 ← 存在 `src/scripts/` 则"需要"
+- SKILL.md 关键设计决策 ← 代码中的硬编码常量、特殊处理逻辑、注释说明
+- 注意事项 ← SKILL.md 的异常处理表 + 脚本的错误分支
+
+**还原测试用例**（从 SKILL.md 的异常处理表 + 脚本边界逻辑）：
+- 正常场景 ← SKILL.md 的用法示例
+- 异常场景 ← SKILL.md 的异常处理表 + 脚本中的错误处理分支
+- 不触发场景 ← 从 description 反推边界（相近但不应触发的场景，如"备份数据"对 restore-state）
+
+## 第四步：逐节确认
+
+将整理好的内容分节呈现给用户，每节确认后再继续下一节：
+
+1. 先呈现「需求说明」，问："功能描述和触发场景我整理得对吗？有没有遗漏或需要补充的？"
+2. 再呈现「方案设计」，问："架构和关键设计决策我理解得对吗？"
+3. 最后呈现「测试用例」，问："测试用例是否完整？是否需要增删？"
+
+**与路径A的共同点**：都需要与用户对齐，确保理解正确。
+**与路径A的不同点**：这里是先基于代码给出初步判断再确认，而非从零开始提问。
+
+## 第五步：写入 design.md
+
+用户逐节确认后，写入 `<skills_dir>/<name>/design.md`。
+
+**格式严格遵循** [references/skill-notes.md](references/skill-notes.md) **§十「design.md 规范」**：
+
+```markdown
+# <skill-name> 设计文档
+
+## 一、需求说明
+- 功能描述
+- 触发场景（用户怎么说话会触发）
+- 输入/输出约定
+- 上线平台及 type 选择理由
+
+## 二、方案设计
+- 目录结构
+- 是否需要脚本及理由
+- SKILL.md 关键设计决策
+- 注意事项
+
+## 三、测试用例
+| 编号 | 测试场景 | 触发语句 | 预期匹配 | 预期行为 | 预期输出 |
+```
+
+**补充说明**（在规范结构基础上可酌情扩充）：
+- 「需求说明」可追加"核心能力""不触发场景"小节，帮助完善边界描述
+- 「方案设计」可追加"架构""职责划分"小节，补充架构图和组件分工表
+- 以上为可选扩充，规范中的 4 个要点和表头必须保留

package/skills/sophclaw-skill-creator/src/scripts/generate.py

@@ -127,12 +127,13 @@ def parse_resources(raw_resources):
     return deduped, ""
 
 
-def generate_skill(skill_name, skill_type, display_name, skill_description, resources):
+def generate_skill(skill_name, skill_type, display_name, skill_description, resources, output_dir=None):
     """Create the full skill directory structure."""
     today = date.today().isoformat()
     skill_title = title_case_skill_name(skill_name)
 
-    skill_dir = Path.cwd() / "skills" / skill_name
+    base = Path(output_dir) if output_dir else Path.cwd() / "skills"
+    skill_dir = base / skill_name
     src_dir = skill_dir / "src"
 
     # Check for existing directory
@@ -209,6 +210,7 @@ def main():
     parser.add_argument("--display-name", default="", help="Chinese display name (required for store)")
     parser.add_argument("--skill-description", default="", help="Chinese description (required for store)")
     parser.add_argument("--resources", default="", help="Comma-separated: scripts,references,assets")
+    parser.add_argument("--output-dir", default="", help="Output directory for the skill (defaults to ./skills/)")
     args = parser.parse_args()
 
     # Validate name
@@ -252,6 +254,7 @@ def main():
         display_name=args.display_name.strip(),
         skill_description=args.skill_description.strip(),
         resources=resources,
+        output_dir=args.output_dir.strip() or None,
     )
 
     if not success: