@capyclaw/ppt-skill-ppt 0.0.0-stage → 2.2.1

package/cordis.patch.yml

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

package/lib/index.mjs

@@ -0,0 +1,23 @@
+/** @capyclaw/ppt-skill-ppt（目录 dsh-ppt-skill-ppt）：单 skill provider。 */
+import { fileURLToPath } from 'node:url'
+import { createSkillProvider } from './provider.mjs'
+
+export const name = 'ppt-skill-ppt'
+export const inject = ['skills']
+const SKILL = "ppt"
+
+function defaultProvider(config = {}) {
+  return createSkillProvider({
+    assetRoot: config.assetRoot ?? fileURLToPath(new URL('../skills/', import.meta.url)),
+    contractRoot: config.contractRoot ?? fileURLToPath(new URL('../contract/', import.meta.url)),
+    contractFile: 'ppt-contract.json',
+    providerName: "dsh-ppt-ppt",
+    skillDirs: [SKILL],
+    contractNote: (version, skillName) => (String(skillName || '').startsWith('pptmaster-')
+      ? ''
+      : '契约：PPTist Workbench ' + version + '。动作前先调用 ppt_capabilities；工具缺失或 major 不一致时停止，并提示用户安装/升级 @capyclaw/ppt-suite。'),
+  })
+}
+
+export function createProvider(config = {}) { return defaultProvider(config) }
+export function apply(ctx, config = {}) { ctx.skills.registerProvider(() => defaultProvider(config)) }

package/lib/provider.mjs

@@ -0,0 +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}` : '') }
+    },
+  }
+}

package/package.json

@@ -1,6 +1,43 @@
 {
   "name": "@capyclaw/ppt-skill-ppt",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.2.1",
+  "description": "PPT skill：PPT 总入口：按意图路由到执行、成稿、审美、审计、研究技能。",
+  "type": "module",
+  "main": "./lib/index.mjs",
+  "exports": {
+    ".": "./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 路由",
+    "description": "PPT 总入口：按意图路由到执行、成稿、审美、审计、研究技能。"
+  },
+  "files": [
+    "lib/",
+    "skills/",
+    "contract/",
+    "cordis.patch.yml",
+    "README.md"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "test": "node --test test/smoke.test.mjs"
+  },
+  "dependencies": {
+    "@capyclaw/plugin-kit": "^0.2.0"
+  }
+}

package/skills/ppt/SKILL.md

@@ -0,0 +1,37 @@
+---
+name: ppt
+description: PPT 演示文稿总入口：默认先路由到“纯执行/成稿”，审美与审计作为独立技能按需加载，不混入日常修改。
+whenToUse: 用户提到 PPT、演示文稿、幻灯片、Keynote、deck，或要求生成/修改/美化/预览演示内容时。
+---
+
+# PPT 工作台路由
+
+本技能只做路由。执行、审美、审计是三条独立链路：
+
+| 用户意图 | 加载技能 | 负责什么 |
+|---|---|---|
+| 方案结构、故事线、目录、章节、一页一观点 | `pptmaster-narrative` | 内容叙事，不碰工具/视觉 |
+| 调工具、schema、编辑器状态、撤销、页面命令 | `pptist-api` | PPTist API 操作手册 |
+| 打开/保存本地 .pptx | `pptist-api` | `ppt_import_pptx` / `ppt_export_pptx`，不手写 OOXML |
+| 从叙事骨架落到干净成稿 | `pptist-authoring` | 桥接层：骨架 → 简洁版式工具 |
+| 改现有 deck（文字/背景/元素/页/图片） | `pptist-editing` | **纯执行**：指哪打哪，不审美、不审计、不回头验证 |
+| 配色、字体、版式、设计 token、反 AI slop | `pptmaster-design` | 独立审美技能，只在用户明确要审美判断时加载 |
+| 审计、截图、交付前检查 | `pptist-visual-check` | 独立验收技能，只在用户明确要求检查/验收时加载 |
+| 查资料、找数据、找配图 | `pptist-research` | 外部研究，产出分析卡 |
+
+## 加载顺序
+
+- **改现有 deck**：默认只加载 `pptist-editing`。用户没说“美化/配色/版式”时不加载 `pptmaster-design`；用户没说“检查/审计/验收/截图”时不加载 `pptist-visual-check`。
+- **从零做方案**：`pptmaster-narrative` → `pptist-authoring`。`pptist-authoring` 默认出 clean 简洁稿；审美定制再叠加 `pptmaster-design`，验收再叠加 `pptist-visual-check`。
+- **只做审美**：`pptmaster-design`。
+- **只做审计/截图**：`pptist-visual-check`。
+- **带外部资料**：`pptist-research` → `pptmaster-narrative` → `pptist-authoring`（审美/审计仍按需）。
+
+## 交叉规则
+
+- 叙事技能不调用工具；设计技能不调用工具；执行技能不做审美判断；审计技能不负责改稿。
+- 先 `ppt_capabilities` 确认 contract 2.x 和编辑器状态；工具参数细节读 `pptist-api` 技能（安装包内随附构建生成的 `references/tool-contract.md`，源码树不保存该文件）。
+- 用户说“背景/页面/幻灯片/标题”默认指右侧 PPTist 编辑器。
+- 新建 deck 默认走内置简洁版式，不要另加装饰层。
+- 编辑/成稿默认**不主动审计、不主动截图**；只有用户明确要求验收时，才由 `pptist-visual-check` 执行。
+- 工具返回已含回执；改完一句话说明结果，不贴 JSON。

package/skills/ppt/references/design-system.md

@@ -0,0 +1,61 @@
+# PPTist 设计基线（按需读取）
+
+## 画布
+
+- 尺寸：1000 × 562.5（16:9）。
+- 安全边距：左右 ≥ 56，上 ≥ 44，下 ≥ 40。
+- 标题区高度：64–96；正文区从 y=140 开始。
+
+## 字号
+
+| 角色 | 字号 |
+|---|---|
+| 封面主标题 | 44–56 |
+| 页面标题 | 36–44 |
+| 章节过渡标题 | 40–48 |
+| 正文 / 要点 | 18–22 |
+| 注释 / 来源 | 11–13 |
+| 大数字 | 56–72 |
+
+一页最多一个主标题；标题不超过两行。
+
+## 颜色
+
+- 默认简洁路线使用内置 clean 主题色，不另造一套。
+- 正文与背景对比度至少 4.5:1；深底用白字，浅底用深灰/黑。
+- 强调色只占 10% 面积；不要整页高饱和。
+- `ppt_recolor` 会同时处理背景、文字对比色和装饰形状，整体换色优先用它。
+
+## 版式
+
+| 版式 | 结构 |
+|---|---|
+| 封面 | 主标题 + 副标题 + 讲者/日期；可加一条装饰线 |
+| 目录 | 3–6 项，纵向排列，编号对齐 |
+| 章节过渡 | 大编号 + 章节标题 + 一句引导 |
+| 要点页 | 标题 + 3–4 条要点；每条不超过两行 |
+| 两栏 | 左文右图或左图右文；两栏间距 ≥ 32 |
+| 数据页 | 1–3 个大数字 + 一行解释；数字优先 |
+| 引用页 | 一句引文 + 出处；引文不超过三行 |
+| 结尾 | 一句收束 + 联系方式/致谢 |
+
+## 内容密度
+
+- 每页一个信息点；不要把整段文字塞进一页。
+- 每章 2–4 条要点；超过就拆章。
+- 标题 ≤ 10 字，要点 ≤ 20 字，detail ≤ 30 字。
+- 能用量化指标就不写形容词。
+
+## 图片
+
+- 单张主图占 40–60% 画布宽度；不要与文字抢同一块区域。
+- 保持原始宽高比；`ppt_image` 会自动等比缩放。
+- 图片上压字时加半透明遮罩或改用纯色块。
+- 外部图片先确认来源/授权；热链可能被编辑器拦截。
+
+## 交付检查
+
+- 每页标题是否一眼可读？
+- 是否有文字溢出/重叠/对比度不足？
+- 整体版式与配色是否统一？
+- 最后一页是否明确收束？