@capyclaw/ppt-skill-editing 2.2.0 → 2.2.1

package/README.md

@@ -1,3 +1,3 @@
-# dsh-ppt-skill-editing
+# @capyclaw/ppt-skill-editing
 
 PPT skill 单包：`pptist-editing`。只注册一个 skill provider，不启动服务。

package/contract/ppt-contract.json

@@ -1,6 +1,6 @@
 {
   "contractVersion": "2.4.0",
-  "packageVersion": "2.4.0",
+  "packageVersion": "2.4.2",
   "toolCount": 27,
   "tools": [
     {

package/cordis.patch.yml

@@ -1,4 +1,4 @@
-# dsh-ppt-skill-editing bundle patch：只注册 pptist-editing 一个 skill provider。
+# @capyclaw/ppt-skill-editing（目录 dsh-ppt-skill-editing） bundle patch：只注册 pptist-editing 一个 skill provider。
 - insert:
     - id: ppt-skill-editing
-      name: dsh-ppt-skill-editing
+      name: @capyclaw/ppt-skill-editing

package/lib/index.mjs

@@ -1,4 +1,4 @@
-/** dsh-ppt-skill-editing：单 skill provider。 */
+/** @capyclaw/ppt-skill-editing（目录 dsh-ppt-skill-editing）：单 skill provider。 */
 import { fileURLToPath } from 'node:url'
 import { createSkillProvider } from './provider.mjs'
 
@@ -15,7 +15,7 @@ function defaultProvider(config = {}) {
     skillDirs: [SKILL],
     contractNote: (version, skillName) => (String(skillName || '').startsWith('pptmaster-')
       ? ''
-      : '契约：PPTist Workbench ' + version + '。动作前先调用 ppt_capabilities；工具缺失或 major 不一致时停止，并提示用户安装/升级 dsh-ppt-suite。'),
+      : '契约：PPTist Workbench ' + version + '。动作前先调用 ppt_capabilities；工具缺失或 major 不一致时停止，并提示用户安装/升级 @capyclaw/ppt-suite。'),
   })
 }
 

package/lib/provider.mjs

@@ -1,82 +1,82 @@
-/** 通用 skill provider：从目录扫描 kebab-case SKILL.md，按需加载正文。 */
-import { readFileSync } from 'node:fs'
-import { readFile } from 'node:fs/promises'
-import { isAbsolute, join, sep } from 'node:path'
-
-const NAME_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/
-const RANK = 600
-
-function parseSkill(raw, path) {
-  const frontmatter = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/u.exec(raw)
-  if (!frontmatter?.[1]) throw new Error(`skill ${path} 缺少 YAML frontmatter`)
-  const meta = {}
-  for (const line of frontmatter[1].split(/\r?\n/)) {
-    const match = /^([A-Za-z0-9_-]+):\s*(.*)$/.exec(line)
-    if (match) meta[match[1]] = match[2].replace(/^['"]|['"]$/g, '').trim()
-  }
-  if (!meta.name || !meta.description) throw new Error(`skill ${path} 缺少 name/description`)
-  if (!NAME_RE.test(meta.name)) throw new Error(`skill ${path} name 必须是 kebab-case`)
-  return {
-    name: meta.name,
-    description: meta.description,
-    whenToUse: meta.whenToUse || undefined,
-    content: raw.slice(frontmatter[0].length).trim(),
-  }
-}
-
-/**
- * @param {{
- *   assetRoot: string,
- *   skillDirs: string[],
- *   providerName?: string,
- *   contractRoot?: string,
- *   contractNote?: (version: string) => string
- * }} config
- */
-export function createSkillProvider(config) {
-  const assetRoot = config.assetRoot
-  if (!assetRoot || !isAbsolute(assetRoot)) throw new Error('createSkillProvider: assetRoot 必须是绝对路径')
-  let contract = null
-  if (config.contractRoot) {
-    try {
-      contract = JSON.parse(readFileSync(join(config.contractRoot, config.contractFile || 'contract.json'), 'utf8'))
-    } catch { /* 非技能包可以没有契约快照 */ }
-  }
-  const dirs = config.skillDirs || []
-  if (!dirs.length) throw new Error('createSkillProvider: skillDirs 不能为空')
-  const candidates = dirs.map((dir) => {
-    const directory = join(assetRoot, dir)
-    const locator = join(directory, 'SKILL.md')
-    const parsed = parseSkill(readFileSync(locator, 'utf8'), locator)
-    if (parsed.name !== dir) throw new Error(`skill ${locator} name 必须是 ${dir}`)
-    return {
-      name: parsed.name,
-      description: parsed.description,
-      whenToUse: parsed.whenToUse,
-      invocation: { modelInvocable: true, userInvocable: true },
-      provider: config.providerName || 'dsh-plugin',
-      source: 'bundled',
-      rank: RANK,
-      resourceBase: { kind: 'directory', path: directory.split(sep).join('/') },
-      locator,
-    }
-  })
-  const byName = new Map(candidates.map((candidate) => [candidate.name, candidate]))
-  const noteFor = (name) => (contract && config.contractNote
-    ? config.contractNote(contract.contractVersion, name)
-    : '')
-
-  return {
-    name: config.providerName || 'dsh-plugin',
-    list: () => Promise.resolve(candidates),
-    async get(candidate, options = {}) {
-      const hit = byName.get(candidate.name)
-      if (!hit) throw new Error(`未知 skill ${candidate.name}`)
-      const raw = await readFile(hit.locator, { encoding: 'utf8', signal: options.signal })
-      const parsed = parseSkill(raw, hit.locator)
-      const { rank: _rank, locator: _locator, ...summary } = hit
-      const note = noteFor(candidate.name)
-      return { ...summary, content: parsed.content + (note ? `\n\n---\n\n${note}` : '') }
-    },
-  }
-}
+/** 通用 skill provider：从目录扫描 kebab-case SKILL.md，按需加载正文。 */
+import { readFileSync } from 'node:fs'
+import { readFile } from 'node:fs/promises'
+import { isAbsolute, join, sep } from 'node:path'
+
+const NAME_RE = /^[a-z0-9]+(?:-[a-z0-9]+)*$/
+const RANK = 600
+
+function parseSkill(raw, path) {
+  const frontmatter = /^---\r?\n([\s\S]*?)\r?\n---(?:\r?\n|$)/u.exec(raw)
+  if (!frontmatter?.[1]) throw new Error(`skill ${path} 缺少 YAML frontmatter`)
+  const meta = {}
+  for (const line of frontmatter[1].split(/\r?\n/)) {
+    const match = /^([A-Za-z0-9_-]+):\s*(.*)$/.exec(line)
+    if (match) meta[match[1]] = match[2].replace(/^['"]|['"]$/g, '').trim()
+  }
+  if (!meta.name || !meta.description) throw new Error(`skill ${path} 缺少 name/description`)
+  if (!NAME_RE.test(meta.name)) throw new Error(`skill ${path} name 必须是 kebab-case`)
+  return {
+    name: meta.name,
+    description: meta.description,
+    whenToUse: meta.whenToUse || undefined,
+    content: raw.slice(frontmatter[0].length).trim(),
+  }
+}
+
+/**
+ * @param {{
+ *   assetRoot: string,
+ *   skillDirs: string[],
+ *   providerName?: string,
+ *   contractRoot?: string,
+ *   contractNote?: (version: string) => string
+ * }} config
+ */
+export function createSkillProvider(config) {
+  const assetRoot = config.assetRoot
+  if (!assetRoot || !isAbsolute(assetRoot)) throw new Error('createSkillProvider: assetRoot 必须是绝对路径')
+  let contract = null
+  if (config.contractRoot) {
+    try {
+      contract = JSON.parse(readFileSync(join(config.contractRoot, config.contractFile || 'contract.json'), 'utf8'))
+    } catch { /* 非技能包可以没有契约快照 */ }
+  }
+  const dirs = config.skillDirs || []
+  if (!dirs.length) throw new Error('createSkillProvider: skillDirs 不能为空')
+  const candidates = dirs.map((dir) => {
+    const directory = join(assetRoot, dir)
+    const locator = join(directory, 'SKILL.md')
+    const parsed = parseSkill(readFileSync(locator, 'utf8'), locator)
+    if (parsed.name !== dir) throw new Error(`skill ${locator} name 必须是 ${dir}`)
+    return {
+      name: parsed.name,
+      description: parsed.description,
+      whenToUse: parsed.whenToUse,
+      invocation: { modelInvocable: true, userInvocable: true },
+      provider: config.providerName || 'dsh-plugin',
+      source: 'bundled',
+      rank: RANK,
+      resourceBase: { kind: 'directory', path: directory.split(sep).join('/') },
+      locator,
+    }
+  })
+  const byName = new Map(candidates.map((candidate) => [candidate.name, candidate]))
+  const noteFor = (name) => (contract && config.contractNote
+    ? config.contractNote(contract.contractVersion, name)
+    : '')
+
+  return {
+    name: config.providerName || 'dsh-plugin',
+    list: () => Promise.resolve(candidates),
+    async get(candidate, options = {}) {
+      const hit = byName.get(candidate.name)
+      if (!hit) throw new Error(`未知 skill ${candidate.name}`)
+      const raw = await readFile(hit.locator, { encoding: 'utf8', signal: options.signal })
+      const parsed = parseSkill(raw, hit.locator)
+      const { rank: _rank, locator: _locator, ...summary } = hit
+      const note = noteFor(candidate.name)
+      return { ...summary, content: parsed.content + (note ? `\n\n---\n\n${note}` : '') }
+    },
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capyclaw/ppt-skill-editing",
-  "version": "2.2.0",
+  "version": "2.2.1",
   "description": "PPT skill：指哪打哪的修改执行器：每步落盘、不审美、不审计、不回头验证。",
   "type": "module",
   "main": "./lib/index.mjs",
@@ -8,10 +8,19 @@
     ".": "./lib/index.mjs",
     "./package.json": "./package.json"
   },
+  "engines": {
+    "node": ">=18",
+    "dsh": "^0.2.0-rc.2"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "dsh": {
     "bundle": {
       "patch": "./cordis.patch.yml"
-    }
+    },
+    "category": "skills",
+    "platform": "both"
   },
   "meta": {
     "title": "PPT Skill · PPT 纯执行",
@@ -24,5 +33,11 @@
     "cordis.patch.yml",
     "README.md"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "scripts": {
+    "test": "node --test test/smoke.test.mjs"
+  },
+  "dependencies": {
+    "@capyclaw/plugin-kit": "^0.2.0"
+  }
 }