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

package/cordis.patch.yml

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

package/lib/index.mjs

@@ -0,0 +1,23 @@
+/** @capyclaw/ppt-skill-design（目录 dsh-ppt-skill-design）：单 skill provider。 */
+import { fileURLToPath } from 'node:url'
+import { createSkillProvider } from './provider.mjs'
+
+export const name = 'ppt-skill-design'
+export const inject = ['skills']
+const SKILL = "pptmaster-design"
+
+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-design",
+    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-design",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "2.2.1",
+  "description": "PPT skill：design token、版式、反 AI slop；只做视觉决策。",
+  "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": "design token、版式、反 AI slop；只做视觉决策。"
+  },
+  "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/pptmaster-design/SKILL.md

@@ -0,0 +1,32 @@
+---
+name: pptmaster-design
+description: 方案 deck 设计系统：锁 design token（单一强调色、ink/paper、字体、12 列网格），按登记版式做视觉决策，反 AI slop；只做设计，不调用工具、不做审计、不改稿。
+whenToUse: 用户明确要求配色、字体、版式、视觉调性、反 AI slop，或需要为成稿确定设计 token 时。
+---
+
+# PPTMaster 设计系统
+
+本技能只负责 **视觉决策**。叙事由叙事技能负责，工具操作由执行技能负责，审计/截图由验收技能负责；本技能不调用 `ppt_*` 工具，也不修改 deck。
+
+## 硬纪律
+
+| 纪律 | 治什么 |
+|---|---|
+| **全局锁一套 design token，单一强调色全程不换** | 配色跳变（橙突然变蓝） |
+| **版式跟内容走，但吸附登记版式骨架，不自由发明** | 黑块遮挡 / 元素乱叠 |
+| **几何图形里不写可见文字** | 坐标轴/图表文字翻转 |
+| **内置简洁版式（封面/章节/要点/两栏/大数字/引用/结尾）视为登记版式** | 避免临时发明未登记结构 |
+| **反 AI slop**：无渐变、无 emoji 图标、无圆角卡片+左 border 套路、无 SVG 人像 | 一眼 AI、掉档 |
+
+## 流程
+
+1. **锁 token**：从客户 VI 取色；没有就从预设主题选一套。写死 `{accent, ink, paper, font_sans, grid:12}`，全 deck 引用；不从记忆猜品牌色。
+2. **选版式**：数据→大数字/矩阵/条形；流程→时间线/循环；对比→左右对照；并列判断→等权卡片；结论→大字 statement。每页从登记版式选，不临时发明。
+3. **排版**：12 列网格、左对齐贴近内容轴；中文大标题按字数分档防溢出；主标题:正文字号 ≥ 8:1。
+4. **反 slop**：每个元素必须挣得位置；真图未就位用诚实 placeholder，不硬凑丑 SVG；同一张图不重复。
+
+## 输出
+
+输出 **design token + 版式选择 + 排版约束**，交给成稿/执行技能落地。不要在本技能内改 deck，也不要把审计结论当成设计决策。
+
+详细规则：`references/design-tokens.md`、`references/layout-system.md`、`references/anti-ai-slop.md`。

package/skills/pptmaster-design/references/anti-ai-slop.md

@@ -0,0 +1,18 @@
+# 反 AI Slop
+
+这些是训练数据的“视觉最大公约数”，一眼 AI、抹掉品牌识别度——禁用：
+
+- 紫色/多色渐变。
+- emoji 当图标；用同一套线性图标或纯文字。
+- 圆角卡片 + 左侧 border accent 的套路。
+- 用 SVG/几何图形画人脸、插画或复杂图标。
+- 满屏高亮色；强调色只占很小面积。
+- 用内容填充凑数；每个元素必须挣得位置。
+
+替代方案：
+
+- 严格使用客户 VI 或预设 token。
+- 无衬线（瑞士风）或 serif display（杂志风），一份 deck 不混。
+- 直角、纯色、不透明；只允许 1px hairline 分割线。
+- 极致字号对比和大幅留白。
+- 真图未就位时用带标签的诚实灰块，不硬凑丑图。

package/skills/pptmaster-design/references/design-tokens.md

@@ -0,0 +1,36 @@
+# Design Token 与主题
+
+## 先锁 token，再画任何一页
+
+```json
+{
+  "accent": "#002FA7",
+  "ink": "#0a0a0a",
+  "paper": "#fafaf8",
+  "font_sans": "system-ui / 客户 VI 字体",
+  "grid": 12
+}
+```
+
+- 客户有 VI：用客户主色作为唯一 accent。
+- 没有 VI：从预设主题选一套，不要临时调色。
+- 绝不从记忆猜品牌色；必须来自客户 VI 或明确预设。
+
+## 单一强调色铁律
+
+- 一份 deck 只用一套主题，全程不换 accent。
+- 不混搭两个高亮色；accent 只用于关键数字/单字符/关键线条。
+- 灰阶保持一致：paper / grey-1 / grey-2 / grey-3 / ink；不要用纯白纯黑替代全部灰阶。
+
+## 预设主题
+
+| 主题 | accent | 适合 |
+|---|---|---|
+| 克莱因蓝 | `#002FA7` | 通用/商业/科技，默认 |
+| 柠檬黄 | `#FFD500` | 年轻/运动/零售；accent 上文字用纯黑 |
+| 柠檬绿 | `#C5E803` | 生态/未来/Z 世代；accent 上文字用纯黑 |
+| 安全橙 | `#FF6B35` | 工业/警示/紧迫；白字加粗 |
+
+## 审计
+
+确定性审计应检查：非中性色种类 > 3 → 配色漂移；渐变/阴影/大圆角 → 风格风险。

package/skills/pptmaster-design/references/layout-system.md

@@ -0,0 +1,30 @@
+# 版式系统
+
+## 内容 → 版式
+
+| 内容 | 版式 |
+|---|---|
+| 数据/数字 | 大数字 Data Hero / 矩阵 / 横向条形 |
+| 流程 | 时间线 / 循环 / 系统图 |
+| 对比 | 左右对照 |
+| 并列判断 | 等权卡片 / 网格 |
+| 结论 | 大字 statement / manifesto |
+
+## 登记版式
+
+正文页从登记版式选并保持骨架，不要临时发明未登记结构。内置简洁版式（封面/目录/章节/单栏要点/双栏/大数字/矩阵/时间线/引用/结尾）本身属于登记版式。
+
+```text
+封面 / 目录 / Brief 开场
+章节过渡
+单栏要点 / 双栏 / 大数字 / 矩阵 / 时间线
+引用 / statement / 结尾行动
+```
+
+吸附网格槽位能避免黑块遮挡和元素乱叠。
+
+## 几何与文字
+
+- 几何图形只画线、圆、箭头、路径；可见文字放在 HTML/文本框里，绝不塞进几何图形。
+- 中文大标题按字数分档限高，避免溢出；主标题:正文 ≥ 8:1。
+- 12 列网格，左对齐贴近左上内容轴；除 statement 类版式外不要居中。