skill-creator 2.3.1 → 2.4.0

package/dist/webui/_app/immutable/nodes/{1.CY3UBo6A.js → 1.BY0DmHLP.js}

@@ -1 +1 @@
-import{B as e,Ct as t,F as n,R as r,St as i,ct as a,lt as o,nt as s,st as c}from"../chunks/CmCJ0SKP.js";import"../chunks/xihTtKlq.js";import{t as l}from"../chunks/C8EbtR4g.js";var u=e(`<h1> </h1> <p> </p>`,1);function d(e,d){t(d,!0);var f=u(),p=c(f),m=a(p,!0),h=o(p,2),g=a(h,!0);s(()=>{n(m,l.status),n(g,l.error?.message)}),r(e,f),i()}export{d as component};
+import{B as e,Ct as t,F as n,R as r,St as i,ct as a,lt as o,nt as s,st as c}from"../chunks/CmCJ0SKP.js";import"../chunks/xihTtKlq.js";import{t as l}from"../chunks/CvO5eq4f.js";var u=e(`<h1> </h1> <p> </p>`,1);function d(e,d){t(d,!0);var f=u(),p=c(f),m=a(p,!0),h=o(p,2),g=a(h,!0);s(()=>{n(m,l.status),n(g,l.error?.message)}),r(e,f),i()}export{d as component};

package/dist/webui/_app/immutable/nodes/{2.BfHkaxce.js → 2._osi8D6m.js}

@@ -1 +1 @@
-import{B as e,Ct as t,R as n,St as r,c as i,r as a}from"../chunks/CmCJ0SKP.js";import{t as o}from"../chunks/_g2_n9ND.js";import"../chunks/xihTtKlq.js";import"../chunks/D_Wlt2rL.js";import"../chunks/DZ_Kltd5.js";var s=e(`<div class="flex h-full items-center justify-center text-sm text-muted-foreground" role="status">Opening Skill Creator…</div>`);function c(e,c){t(c,!1),a(()=>{o(`/workspaces`,{replaceState:!0})}),i();var l=s();n(e,l),r()}export{c as component};
+import{B as e,Ct as t,R as n,St as r,c as i,r as a}from"../chunks/CmCJ0SKP.js";import{t as o}from"../chunks/B0stYqX9.js";import"../chunks/xihTtKlq.js";import"../chunks/oJ4aK8PG.js";import"../chunks/DZ_Kltd5.js";var s=e(`<div class="flex h-full items-center justify-center text-sm text-muted-foreground" role="status">Opening Skill Creator…</div>`);function c(e,c){t(c,!1),a(()=>{o(`/workspaces`,{replaceState:!0})}),i();var l=s();n(e,l),r()}export{c as component};

package/dist/webui/_app/version.json

@@ -1 +1 @@
-{"version":"1790701391698"}
+{"version":"1790796137455"}

package/dist/webui/index.html

@@ -8,42 +8,43 @@
     <meta charset="utf-8" />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <meta name="text-scale" content="scale" />
-    <link href="/_app/immutable/entry/start.BCFPuXD4.js" rel="modulepreload">
-		<link href="/_app/immutable/chunks/_g2_n9ND.js" rel="modulepreload">
+    <link href="/_app/immutable/entry/start.gejSBBnR.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/B0stYqX9.js" rel="modulepreload">
 		<link href="/_app/immutable/chunks/CmCJ0SKP.js" rel="modulepreload">
-		<link href="/_app/immutable/entry/app.BbnICwcR.js" rel="modulepreload">
+		<link href="/_app/immutable/entry/app.SX0t6ojk.js" rel="modulepreload">
 		<link href="/_app/immutable/chunks/HclGiUj8.js" rel="modulepreload">
 		<link href="/_app/immutable/chunks/xihTtKlq.js" rel="modulepreload">
-		<link href="/_app/immutable/nodes/0.C0a-_hPX.js" rel="modulepreload">
-		<link href="/_app/immutable/chunks/C8EbtR4g.js" rel="modulepreload">
-		<link href="/_app/immutable/chunks/D_Wlt2rL.js" rel="modulepreload">
+		<link href="/_app/immutable/nodes/0.BTXc1wYu.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/CvO5eq4f.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/oJ4aK8PG.js" rel="modulepreload">
 		<link href="/_app/immutable/chunks/BkEnd9_Z.js" rel="modulepreload">
-		<link href="/_app/immutable/chunks/Do5hAkYk.js" rel="modulepreload">
-		<link href="/_app/immutable/chunks/BHJkoxm8.js" rel="modulepreload">
-		<link href="/_app/immutable/chunks/1vzbRbJ2.js" rel="modulepreload">
-		<link href="/_app/immutable/chunks/BT2vrlul.js" rel="modulepreload">
-		<link href="/_app/immutable/chunks/Bs7CGcv2.js" rel="modulepreload">
-		<link href="/_app/immutable/chunks/CsxdqaKQ.js" rel="modulepreload">
-		<link href="/_app/immutable/chunks/D-2QBE8y.js" rel="modulepreload">
-		<link href="/_app/immutable/chunks/1aUphu7Y.js" rel="modulepreload">
-		<link href="/_app/immutable/chunks/825uWMzf.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/Cp0lquqA.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/DlsPNMHX.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/Crg8KRap.js" rel="modulepreload">
 		<link href="/_app/immutable/chunks/DnPeA-9c.js" rel="modulepreload">
 		<link href="/_app/immutable/chunks/BEPs9Z9s.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/D7DTLcps.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/BT2vrlul.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/B_gnhZ39.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/CdjBDc_u.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/BgJCuTDs.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/1aUphu7Y.js" rel="modulepreload">
 		<link href="/_app/immutable/chunks/DZ_Kltd5.js" rel="modulepreload">
 		<link href="/_app/immutable/chunks/DOjT7y5f.js" rel="modulepreload">
 		<link href="/_app/immutable/chunks/DApmS1g_.js" rel="modulepreload">
-		<link href="/_app/immutable/chunks/DgfWqxEz.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/M-b0y9AQ.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/Do_MDwCJ.js" rel="modulepreload">
 		<link href="/_app/immutable/chunks/F_BrNiaz.js" rel="modulepreload">
 		<link href="/_app/immutable/chunks/CpRvgjpe.js" rel="modulepreload">
 		<link href="/_app/immutable/chunks/UeEccMjN.js" rel="modulepreload">
 		<link href="/_app/immutable/chunks/BIfnT_mK.js" rel="modulepreload">
-		<link href="/_app/immutable/chunks/N4Ne5qCB.js" rel="modulepreload">
+		<link href="/_app/immutable/chunks/Ccj5eiVa.js" rel="modulepreload">
 		<link href="/_app/immutable/chunks/HopcQwhZ.js" rel="modulepreload">
 		<link href="/_app/immutable/chunks/ChvFFUWR.js" rel="modulepreload">
 		<link href="/_app/immutable/chunks/C67g-p2T.js" rel="modulepreload">
 		
 		<link href="/_app/immutable/assets/shell.U4CQV8re.css" rel="stylesheet">
-		<link href="/_app/immutable/assets/0.Ce1ZW9xU.css" rel="stylesheet">
+		<link href="/_app/immutable/assets/0.B4ZC2KQW.css" rel="stylesheet">
 		<link href="/_app/immutable/assets/ProviderView.BKgtsfqs.css" rel="stylesheet">
 		<link href="/_app/immutable/assets/SettingsPage.DclbL_Wf.css" rel="stylesheet">
   </head>
@@ -51,15 +52,15 @@
     <div style="display: contents">
 			<script>
 				{
-					__sveltekit_1fl5ljk = {
+					__sveltekit_1doh4mr = {
 						base: ""
 					};
 
 					const element = document.currentScript.parentElement;
 
 					Promise.all([
-						import("/_app/immutable/entry/start.BCFPuXD4.js"),
-						import("/_app/immutable/entry/app.BbnICwcR.js")
+						import("/_app/immutable/entry/start.gejSBBnR.js"),
+						import("/_app/immutable/entry/app.SX0t6ojk.js")
 					]).then(([kit, app]) => {
 						kit.start(app, element);
 					});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skill-creator",
-  "version": "2.3.1",
+  "version": "2.4.0",
   "description": "A local-first CLI and tray workbench for discovering, creating, validating, and installing agent skills.",
   "keywords": [
     "ccski",
@@ -26,6 +26,7 @@
   },
   "files": [
     "dist",
+    "skills",
     "README.md",
     "README-zh.md",
     "LICENSE",

package/skills/skill-creator-v2/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: skill-creator-v2
+description: 本机 Agent 技能工作台 Skill Creator (V2) 的使用指南。当需要搜索/查找本机已安装技能（find/search skills）、读取技能全文、管理技能（安装/更新/启停/校验/清理重复）、维护 skill wiki，或用户提到 skill-creator / skill creator / 技能管理器 / skills manager / SKILL.md 管理时使用。两条通路：CLI（skill-creator search / wiki / mcp …）与只读 MCP 工具面（skills_search / skills_info / wiki_read …）；变更类操作一律经 Skill Creator GUI 人工审批。
+x-managed-by: skill-creator
+---
+
+<!--
+文件意图：本目录是 Skill Creator 产品自带的官方技能源（随 npm 包 / git 仓库分发）。
+~/.agents/skills/skill-creator-v2 是指向本目录的符号链接（daemon 启动时自举维护，
+来源经 package.json 身份鉴定）。内容是产品对外行为面（CLI + MCP readonly 工具）的
+文档投影，事实源在产品仓库；升级包后本文件自动保鲜，无需任何迁移。
+-->
+
+# Skill Creator V2 — 本机技能管理与检索入口
+
+Skill Creator 是本机的技能工作台：管理所有 Agent 的技能目录（发现 / 校验 / 启停 /
+安装 / 更新 / 修订历史），并提供本地 BM25 检索与技能 wiki。本机全部技能按
+Workspace（`~` = 全局聚合，或已导入的 ws_* 目录）→ Provider（claude-code / codex /
+cursor / zcode 等 Agent 的 skills root）两层作用域组织。
+
+## 通路选择
+
+```text
+要做什么？
+├─ 找技能 / 搜本机已装技能 ──────────> CLI: skill-creator search <query>
+│                                      或 MCP: skills_search {query, limit?}
+├─ 读某个技能的全文 / 校验它 ─────────> MCP: skills_search 拿 {workspaceId,
+│                                      providerId, skillId} 三元组
+│                                      → skills_info / skills_validate
+├─ 列出本机有哪些 Workspace/Provider > MCP: workspace_list
+├─ 装新技能 / 更新 / 启停 / 编辑 ─────> 引导用户在 GUI 操作（skill-creator start）；
+│                                      读写面只读，mutation 需 GUI 人工审批
+├─ 技能经验 / 认知碎片 wiki ──────────> CLI: skill-creator wiki <子命令>
+│                                      或 MCP: wiki_scopes / wiki_list / wiki_read
+└─ 结构化批量消费（推荐常驻）─────────> 注册 MCP: skill-creator mcp（stdio，只读）
+```
+
+## 硬规则
+
+- **只读面**：CLI/MCP 通路对技能数据只读；安装、更新、启停、编辑、删除都在
+  Skill Creator GUI 内完成（`skill-creator start` 启动）——先向用户说明要做什么、
+  影响哪些技能，再引导操作，不要声称"已修改"。
+- **opaque id**：skillId（`sk_*`）与三元组由服务端签发，不要手工拼路径或猜测；
+  永远先 `skills_search` / `workspace_list` 拿真 id。
+- **搜索不需要 daemon**：`skill-creator search` 进程内完成（首次建索引稍慢）。
+
+## 深入
+
+完整 MCP 工具目录（含每个工具的输入形状）、CLI 全参考、Workspace/Provider 概念
+与 MCP stdio 注册片段见 [references/tools.md](references/tools.md)。

package/skills/skill-creator-v2/references/tools.md

@@ -0,0 +1,161 @@
+# Skill Creator 工具参考
+
+事实源：CLI 帮助（`skill-creator help`）与产品 capability 登记表。工具名规则：
+capability 名点号→下划线（`skills.search` → `skills_search`）。
+
+## 概念模型
+
+```text
+Workspace（作用域第一层）
+  |-- "~"      Global Workspace：聚合所有 Agent 的全局 skills roots（只读消费）
+  `-- ws_*     Imported Workspace：已导入的本机目录（可写：创建/编辑/安装）
+Provider = 一个 Workspace 内的 Agent skills root（providerId ∈ 社区 catalog：
+  claude-code / codex / cursor / zcode / gemini-cli / warp / zed …）
+技能身份 = { workspaceId, providerId, skillId(sk_*) } 三元组（服务端 opaque 签发）
+```
+
+- Global（`~`）可发现/查看/校验/启停既有技能，但创建与安装目标只能是 Imported
+  Workspace——装技能前先用 `workspace_list` 确认可写目标，没有就引导用户在 GUI
+  导入目录。
+- 同一技能可能出现在多个 provider root（内容重复）；`skills_duplicates` 给出
+  contentHash 分组，去重决策留给用户。
+
+## MCP 通路（结构化消费推荐）
+
+注册 stdio server（readonly 面，不需要 daemon 常驻）：
+
+```json
+{
+  "mcpServers": {
+    "skill-creator": { "command": "skill-creator", "args": ["mcp"] }
+  }
+}
+```
+
+（各宿主的 MCP 配置位置不同：Claude Code `claude mcp add skill-creator -- skill-creator mcp`；
+ZCode/Codex/其它宿主写各自 mcp 配置，命令同为 `skill-creator mcp`。）
+
+### 只读工具目录（stdio / daemon 内同构）
+
+| 工具                        | 输入（JSON）                                    | 用途                                                                                                                                    |
+| --------------------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------- |
+| `workspace_list`            | {}                                              | 列 Workspace（含 provider roots 与计数）                                                                                                |
+| `skills_list`               | {workspaceId, providerId, includeDisabled?}     | 列一个 provider 的技能                                                                                                                  |
+| `skills_info`               | {workspaceId, providerId, skillId}              | 读技能全文 + 元数据                                                                                                                     |
+| `skills_validate`           | {workspaceId, providerId, skillId}              | 校验技能结构/frontmatter                                                                                                                |
+| `skills_search`             | {query, limit? (1-50, 默认 10)}                 | 跨全部 Workspace 的 BM25 检索                                                                                                           |
+| `skills_duplicates`         | {}                                              | 内容重复技能分组                                                                                                                        |
+| `skills_search_config_open` | {}                                              | 用系统编辑器打开检索排除配置                                                                                                            |
+| `skills_update_check`       | {workspaceId, providerId, skillIds?}            | 对照上游 lock hash 的过期检查                                                                                                           |
+| `creator_load`              | {workspaceId, providerId, skillId}              | 可编辑文档基线（含 revision）                                                                                                           |
+| `creator_revisions`         | {workspaceId, providerId, skillId, limit? ≤100} | 修订历史（含 diff）                                                                                                                     |
+| `repository_scan`           | {source, ref?}                                  | 浅克隆+钉 commit+扫描 Git 技能源                                                                                                        |
+| `repository_sources_list`   | {}                                              | 列 curated/user 发现源（https Git）                                                                                                     |
+| `wiki_scopes`               | {}                                              | 列 wiki 作用域（global + 各 workspace）                                                                                                 |
+| `wiki_list`                 | {scope}                                         | 列一个作用域的 pattern 碎片                                                                                                             |
+| `wiki_read`                 | {scope, name}                                   | 读一篇 pattern 全文                                                                                                                     |
+| `wiki_distill_start`        | {source, limit? ≤100}                           | 蒸馏 run（需产品 agent 内核；独立 stdio 形态下 start 正常返回 runId，run 立即 failed(kernel-unavailable)，经 wiki_distill_status 可见） |
+| `wiki_distill_status`       | {runId}                                         | 蒸馏 run 状态/提案台账                                                                                                                  |
+| `wiki_distill_cancel`       | {runId}                                         | 取消蒸馏 run                                                                                                                            |
+
+变更类能力（安装/更新执行/启停/编辑/删除/写 wiki）在 MCP 面只有 `*_propose`
+提案变体且仅存在于产品 GUI 的内置会话——外部 Agent 一律引导用户在 GUI 完成。
+
+MCP resource 面：`skill-creator://skill/{workspaceId}/{providerId}/{skillId}`
+（技能文档只读资源）。
+
+## CLI 全参考
+
+```text
+skill-creator start          Boot the daemon and open the tray window
+skill-creator open           Show/focus the tray window of a running daemon
+skill-creator openinbrowser  Open the running WebUI in the system browser
+skill-creator status         Check the running daemon
+skill-creator stop           Gracefully stop the daemon
+skill-creator search         Search local skills (BM25 + skill tokenizer)
+skill-creator wiki           Persistent agent-experience wiki
+                             (list/show/add/find/edit/remove/log/impact/scopes/distill)
+skill-creator skills         Manage skills (list/info/validate/toggle/duplicates/update)
+skill-creator model          Configure agent models (list/routes/use/route/key/test)
+skill-creator mcp            Run the skill-creator MCP server over stdio (readonly face)
+skill-creator setup          Install/repair the global self skill link + agents-md block;
+                             --model <p>/<m> 配置模型段
+skill-creator self-skill     Inspect the global self skill link (status | keep)
+skill-creator version        Print the version
+skill-creator help           Show this help
+```
+
+### search 细节
+
+```bash
+skill-creator search <query...> [--json] [--limit N]   # limit 1-50，默认 10
+```
+
+- 进程内完成（不要求 daemon 在运行）；空 query 或 flag 解析失败 exit 1。
+- `--json` 输出 `{ "results": [...] }`（每项主要字段：name/description/
+  canonicalPath/score/installations/duplicates，另有 id/contentHash 等）；人读模式
+  含路径与重复项。
+- 中英混合 query 均可（tokenizer 含中文 bigram 与 Latin 标识符切分）。
+
+### wiki 细节
+
+`skill-creator wiki <子命令>` 进程内执行（`distill` 例外，走 daemon RPC）：
+list/show/add/find/edit/remove/log/impact/scopes/distill。`--workspace` 支持
+registry label/ws_id 或路径直传。wiki 目录 = `<workspace>/.agents/skill-wiki/`。
+
+### skills 细节（与 WebUI 同源，进程内执行）
+
+```bash
+skill-creator skills list [<workspace>] [--provider <p>] [--all] [--json]
+skill-creator skills info <workspace> <provider> <skill> [--json]
+skill-creator skills validate <workspace> <provider> <skill>
+skill-creator skills toggle <workspace> <provider> <skill>... (--enable|--disable)
+skill-creator skills duplicates [--json]
+skill-creator skills update check <workspace> <provider> [--json]
+skill-creator skills update apply <workspace> <provider> <skillName>... [--json]
+```
+
+- 引用解析：workspace = `~`/路径/ws_* id/label 前缀；provider = id 或 label 前缀；
+  skill = name/directoryName/sk_ id。歧义或零匹配列出候选并 exit 2。
+- 退出码：0 成功；1 业务失败（validate 无效、toggle conflict、update failed）；
+  2 用法错误。
+- symlink 条目的启停按 conflict 投影（管理链接本身，不穿透改名）。
+
+### model 细节（与 WebUI 同源，进程内执行）
+
+```bash
+skill-creator model list [--json]        # 目录 provider + 路由/活动标注
+skill-creator model routes [--json]      # 路由表 + 活动模型 + key configured 状态
+skill-creator model use <provider> <model> [--effort <tier>]
+skill-creator model route add <provider> --base-url <url> [--api <protocol>] --model <id>...
+skill-creator model route remove <provider>
+skill-creator model key set <provider> <apiKey|->   # `-` 从 stdin 读，避免进 shell 历史
+skill-creator model key clear <provider>
+skill-creator model test [<provider> [<model>]]
+```
+
+- 与 WebUI 同一份持久化（`~/.skill-creator/steward-store/`）；key 明文永不回显。
+- `use` 对目录内 provider 自动补路由（api/baseURL/models 由目录推导）。
+
+### setup 模型段
+
+```bash
+skill-creator setup [--backup] [--model <provider>/<model>] [--effort <tier>] \
+                    [--base-url <url>] [--api <protocol>] [--api-key <key|none>]
+```
+
+- `--model` 是模型段开关；其余模型 flag 必须伴随它（否则 exit 2）。
+- 段内顺序：key set（`none` 跳过）→ route add（无路由且给 `--base-url` 时）→ use。
+- 模型段失败 exit 1，但不回滚已完成的技能链接与 agents-md 块。
+
+## 技能更新模型
+
+skills-CLI（`npx skills`）安装的技能带 lock hash：`skills_update_check` 只读对比
+上游；过期技能的执行重装（apply）在 GUI 完成（Repository 安装管线 + 校验链）。
+手工放入的技能（投影为 installedVia: "unknown"、updatable: false）不参与 lock 对比。
+
+## 安全与边界
+
+- MCP/HTTP 面只监听 loopback；daemon WebUI token 不出本机。
+- 不要绕过工具面直接读写技能文件来做"管理"——启停状态、revision 校验、安装验证
+  都有服务端不变量，绕过会破坏它们。