sophhub 0.4.39 → 0.4.40

package/package.json

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

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

@@ -1,10 +1,20 @@
 {
   "name": "sophclaw-skill-creator",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "types": ["private"],
   "displayName": "Skill 创建向导",
   "description": "在 SophClaw 仓库中创建/修改 Skill 或为已有 Skill 补全 design.md。两条路径：路径 A（创建/修改）三步流程：需求对齐→方案对齐→生成代码；路径 B（补全 design.md）五步流程：确定目标→阅读代码→逆向整理→逐节确认→写入文档",
   "changelog": [
+    {
+      "version": "1.2.0",
+      "date": "2026-06-09",
+      "changes": [
+        "design.md 规范增强：方案设计新增「架构」（ASCII 流程图）和「职责划分」（组件职责表）为强制要点",
+        "关键设计决策要求每条包含「是什么」+「为什么」，帮助维护者理解取舍",
+        "路径 A/B 方案产出模板同步更新，路径 B 第三步新增架构提取步骤",
+        "注意事项新增 UV 相关约束要求：uv run 执行方式、[[tool.uv.index]] 阿里云镜像、pyproject.toml 版本同步"
+      ]
+    },
     {
       "version": "1.1.0",
       "date": "2026-05-28",
@@ -25,5 +35,5 @@
     }
   ],
   "createdAt": "2026-05-25",
-  "updatedAt": "2026-05-28"
+  "updatedAt": "2026-06-09"
 }

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

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

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

@@ -138,13 +138,21 @@ description: 使用 Pillow 库对图片进行有损压缩，支持调整质量
 ## 二、方案设计
 - 目录结构
 - 是否需要脚本及理由
-- SKILL.md 关键设计决策
+- 架构（ASCII 流程图，展示数据流向和关键分支）
+- 职责划分（组件职责表，逐一说明各文件/模块的职责）
+- SKILL.md 关键设计决策（决策项 + 理由，帮助维护者理解 WHY）
 - 注意事项
 
 ## 三、测试用例
 | 编号 | 测试场景 | 触发语句 | 预期匹配 | 预期行为 | 预期输出 |
 ```
 
+> **架构流程图要求**：使用 ASCII 框图展示核心流程，包含关键分支、循环（如轮询）、成功/失败路径。流程图的目的是让接手者在不开代码的情况下理解整体数据流。
+>
+> **关键设计决策要求**：每条决策需包含「是什么」+「为什么」，帮助维护者理解取舍而非仅知道配置值。例如不应只写"默认模型是 Seedance-2.0"，而应补充选择依据。
+>
+> **注意事项要求**：覆盖运维和开发层面的关键约束，包括但不限于：`uv run` 执行方式、`[[tool.uv.index]]` 阿里云镜像源配置、`pyproject.toml` 与 `skill.json` 版本同步、外部依赖、运行时约束、路径约定等。
+
 测试用例至少覆盖：正常场景、不触发场景、边界场景。
 
 用户确认后进入下一步。

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

@@ -61,7 +61,9 @@ digraph design_backfill {
 **还原方案设计**（从脚本代码 + 目录结构）：
 - 目录结构 ← `ls` 查看实际文件树
 - 是否需要脚本及理由 ← 存在 `src/scripts/` 则"需要"
-- SKILL.md 关键设计决策 ← 代码中的硬编码常量、特殊处理逻辑、注释说明
+- 架构 ← 从脚本主流程提取：入口 → 参数解析 → 核心逻辑 → 分支/循环（如轮询）→ 成功/失败出口，用 ASCII 流程图表示
+- 职责划分 ← 整理各文件/模块的职责分工，生成组件职责表
+- SKILL.md 关键设计决策 ← 代码中的硬编码常量、条件分支、特殊处理逻辑，**每条需解释"为什么"而不仅"是什么"**
 - 注意事项 ← SKILL.md 的异常处理表 + 脚本的错误分支
 
 **还原测试用例**（从 SKILL.md 的异常处理表 + 脚本边界逻辑）：
@@ -98,14 +100,21 @@ digraph design_backfill {
 ## 二、方案设计
 - 目录结构
 - 是否需要脚本及理由
-- SKILL.md 关键设计决策
+- 架构（ASCII 流程图，展示数据流向和关键分支）
+- 职责划分（组件职责表，逐一说明各文件/模块的职责）
+- SKILL.md 关键设计决策（决策项 + 理由，帮助维护者理解 WHY）
 - 注意事项
 
 ## 三、测试用例
 | 编号 | 测试场景 | 触发语句 | 预期匹配 | 预期行为 | 预期输出 |
 ```
 
-**补充说明**（在规范结构基础上可酌情扩充）：
-- 「需求说明」可追加"核心能力""不触发场景"小节，帮助完善边界描述
-- 「方案设计」可追加"架构""职责划分"小节，补充架构图和组件分工表
-- 以上为可选扩充，规范中的 4 个要点和表头必须保留
+> **架构流程图**：使用 ASCII 框图展示核心流程，包含关键分支、循环（如轮询）、成功/失败路径。接手者应能在不读代码的情况下理解整体数据流。
+>
+> **关键设计决策**：每条决策需包含「是什么」+「为什么」，帮助维护者理解取舍而非仅知道配置值。
+>
+> **注意事项**：覆盖运维和开发层面的关键约束，包括但不限于：`uv run` 执行方式、`[[tool.uv.index]]` 阿里云镜像源配置、`pyproject.toml` 与 `skill.json` 版本同步、外部依赖、运行时约束、路径约定等。
+
+**可酌情扩充**（规范要点必须保留，以下为补充）：
+- 「需求说明」可追加"核心能力""不触发场景"小节
+- 以上为可选扩充，规范中的 6 个要点和表头必须保留

package/skills/sophclaw-skill-creator/src/references/skill-notes.md

@@ -255,13 +255,27 @@ design.md 在 skill 创建阶段由 LLM 产出，放在 skill 根目录（与 sk
 ## 二、方案设计
 - 目录结构
 - 是否需要脚本及理由
-- SKILL.md 关键设计决策
+- 架构（ASCII 流程图，展示数据流向和关键分支）
+- 职责划分（组件职责表，逐一说明各文件/模块的职责）
+- SKILL.md 关键设计决策（决策项 + 理由，帮助维护者理解 WHY）
 - 注意事项
 
 ## 三、测试用例
 | 编号 | 测试场景 | 触发语句 | 预期匹配 | 预期行为 | 预期输出 |
 ```
 
+> **架构流程图要求**：使用 ASCII 框图展示核心流程，包含关键分支、循环（如轮询）、成功/失败路径。流程图应让接手者在不读代码的情况下理解整体数据流。
+>
+> **关键设计决策要求**：每条决策需包含「是什么」+「为什么」，帮助维护者理解取舍而非仅知道配置值。例如不应只写"默认模型是 Seedance-2.0"，而应补充选择依据。
+>
+> **注意事项要求**：覆盖运维和开发层面的关键约束，包括但不限于：
+> - 执行方式：`uv run` 而非 `python`
+> - 镜像源：`[[tool.uv.index]]` 是否配置了阿里云镜像
+> - 版本同步：`pyproject.toml` version 与 `skill.json` 保持一致
+> - 外部依赖：API Key、第三方服务、系统工具（如 curl）等
+> - 运行时约束：超时时间、轮询间隔、文件存储时效等
+> - 路径约定：SKILL.md 中路径使用运行时路径（不含 `src/`）
+
 ### 用途
 
 - 记录设计决策，供后续维护者参考