@taloswork/ose-shared 0.1.12 → 0.1.14

package/skills/document/rewrite.md

@@ -5,8 +5,8 @@
 - New .docx / .pdf / .xlsx → **Generate** (lines 14–55); a formula in a workbook → also **Formulas** (lines 57–73); a particular look, theme or brand → also **Themes** (lines 75–125)
 - Fill a `{{placeholder}}` .docx / .pptx / .xlsx template → **Fill a template** (lines 127–146)
 - Change an existing .docx — text, structure, comments, tracked changes → **Edit an existing .docx** (lines 148–199)
-- New content in an existing deck's look, or restructure a .pptx → **Template decks** (lines 201–271)
-- Nothing above fits → **Custom scripts** (lines 273–293)
+- New content in an existing deck's look, or restructure a .pptx → **Template decks** (lines 201–281)
+- Nothing above fits → **Custom scripts** (lines 283–308)
 
 A PDF's forms, page ops and stamps are in pdf.md; a deck from scratch is the deck route
 (SKILL.md) — `doc-gen` makes no decks. `<skill>` below is this skill's directory.
@@ -200,27 +200,29 @@ Pick the least lossy path, and tell the user which trade-off you took:
 
 ## Template decks — fill or restructure an existing .pptx
 
-**Which tool**: keep an uploaded deck's LAYOUTS for new content → `pptx-tokenize` →
-`doc-fill`; repeat one styled slide per data item → `pptx-clone`; add, duplicate, drop or
+**Which tool**: a template's STYLE → `template-skin` (deck-design.md "Custom skins");
+its ORIGINAL PAGES refilled, only when asked → `pptx-tokenize` → `doc-fill`; repeat one styled slide per data item → `pptx-clone`; add, duplicate, drop or
 reorder slides → `pptx-slide`; only its COLOURS → `pptx-theme` into a user skin
 (deck-design.md "Custom skins"). Always `doc-validate` the result, then render-and-look.
 
 ### Reuse an uploaded deck — `pptx-tokenize` → `doc-fill`
 
-Only when the user chose the deck as their **style** (the picker's "使用我的模板文件"); a
-deck handed in as **content** is read for its text and authored fresh in the chosen skin.
+Only when the user wants the deck's ORIGINAL PAGES refilled ("就用原页面改字"). A deck
+chosen as a **style** (the picker's "使用我的模板文件") goes through `template-skin`
+(deck-design.md "Custom skins"). On this route: never restyle text globally (font, size,
+colour), never remove the template's logo, footer or other fixed elements without asking.
 
 1. **Tokenize** — every content slot's text (placeholders and plain text boxes) becomes a
    clean single-run `{{token}}`; styling/master/layouts stay verbatim:
    ```
    node <skill>/bin/pptx-tokenize.cjs user.pptx template.pptx schema.json
    ```
-   `schema.json` = `{ slides: [{ index, tokens: [{ token, role, type, multiline?,
+   `schema.json` = `{ slides: [{ index, tokens: [{ token, role, type, multiline?, leadStyle?,
    original?, capacityChars?, rel? }] }] }` — `role` is title / subtitle / body / text /
    pic / chart; `type` is `text`, `image` or `chart`.
 2. **Fill** — `values.json` has one key per `text` token (the key is the token name, no
    braces). **Fill EVERY token**: a slot you keep gets its `original` back (an unfilled
-   token renders EMPTY). `multiline:true` takes a `\n`-joined string. Respect
+   token renders EMPTY). `multiline:true` takes a `\n`-joined string (each line becomes a paragraph). `leadStyle:true` = a bold lead line + body: fill `lead\nbody…` — line 1 takes the lead style, the rest the body style; a single line makes the whole paragraph the lead style. Respect
    `capacityChars` (CJK-width units; a Latin letter ≈ ½) — rewrite shorter rather than
    overflow. `unfilled` in the output names tokens you missed — add them and refill.
    ```
@@ -233,6 +235,14 @@ deck handed in as **content** is read for its text and authored fresh in the cho
    The frame stays put; a different aspect ratio STRETCHES — pre-crop to the slot's ratio.
 4. **Charts** keep the source deck's embedded data (`type:"chart"`, not a fill token) —
    edit the chart part separately, or tell the user the numbers are still theirs.
+5. **Speaker notes** — one call, never hand-written notes XML:
+   ```
+   node <skill>/bin/pptx-notes.cjs final.pptx notes.json final.pptx
+   # notes.json: { "1": "开场定位…", "3": "来源：…" }  (slide positions as shown)
+   ```
+   A hand-written notes slide (2026-10-08: a body placeholder, no `<p:clrMapOvr>`) opened
+   in PowerPoint and LibreOffice and made Keynote refuse the whole file.
+6. **Sign off** with `doc-validate --strict`.
 
 ### One styled slide per data item — `pptx-clone`
 
@@ -291,3 +301,8 @@ other package, never `npm install`. Theme the output by reading a theme JSON you
 Order of escalation: built-in verbs → `doc-run` → raw XML (`doc-xml`). Custom code has no
 safety net but the gate: **`doc-validate --strict` every file it produces** (the full
 ECMA-376 schema check).
+
+A .docx from a `docx` script lacks a default paragraph style (docx.js writes none), and
+Pages then lays every body paragraph out like the heading before it (huge, centred):
+run `bin/docx-defaults.cjs <out.docx> <out.docx>` on it — `doc-validate` fails it as
+`docx-default-style` until you do. A plain document → `doc-gen`, which already has it.

package/skills/document/scenarios.json

@@ -10,8 +10,8 @@
         "故事驱动"
       ],
       "density": [
-        "稀疏",
-        "大数字"
+        "中",
+        "大数字+一句解释"
       ],
       "requiredSections": [
         {
@@ -487,6 +487,11 @@
     {
       "id": "工作汇报",
       "subtitle": "周月季报",
+      "aliases": [
+        "周报",
+        "月报",
+        "季报"
+      ],
       "tone": [
         "客观",
         "简洁",
@@ -609,6 +614,9 @@
     },
     {
       "id": "项目立项/评审",
+      "aliases": [
+        "立项"
+      ],
       "tone": [
         "严谨",
         "说服"
@@ -678,6 +686,9 @@
     },
     {
       "id": "年度总结/年会",
+      "aliases": [
+        "年终总结"
+      ],
       "tone": [
         "振奋",
         "仪式感"
@@ -881,6 +892,9 @@
     },
     {
       "id": "政务/党政汇报",
+      "aliases": [
+        "政务汇报"
+      ],
       "tone": [
         "严肃",
         "规范"
@@ -941,6 +955,9 @@
     },
     {
       "id": "公司/产品介绍",
+      "aliases": [
+        "公司介绍"
+      ],
       "tone": [
         "品牌",
         "自信",

package/skills/document/scenarios.schema.json

@@ -24,6 +24,7 @@
         "properties": {
           "id": { "$ref": "#/$defs/text", "description": "Scenario name as the clarify gate records it; no whitespace." },
           "subtitle": { "$ref": "#/$defs/text", "description": "Alias / gloss shown after the bold id in the md row." },
+          "aliases": { "$ref": "#/$defs/textList", "description": "Other names users call it (周报, 年终总结) that id and subtitle do not split into — findScenario only, not in the md row." },
           "tone": { "$ref": "#/$defs/textList" },
           "density": { "$ref": "#/$defs/textList" },
           "densityEmphasis": { "type": "boolean" },

package/skills/document/styles/_backdrops/rimlight.html

@@ -3,5 +3,6 @@
      (渐变两端渐隐 + feGaussianBlur 打底,跟皮肤默认线 _lines/arc-band.html 同款,包进 .bd-arc,可被
      --line 摘除/替换)。原先用"中心透明→边缘上色"的反向径向渐变会在画面中央糊出一圈突兀的暗色椭圆,
      已弃用,改成方向性更清楚的顶部通栏衰减。变量驱动(__ACCENT__ 自动上色)、明暗中性,可原样复制到
-     任意 styles/<skin>/。 -->
-<svg width="1280" height="720" viewBox="0 0 1280 720" style="position:absolute;inset:0;pointer-events:none"><defs><linearGradient id="rlg" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="__ACCENT__" stop-opacity=".22"/><stop offset=".16" stop-color="__ACCENT__" stop-opacity=".08"/><stop offset=".38" stop-color="__ACCENT__" stop-opacity="0"/></linearGradient></defs><rect width="1280" height="720" fill="url(#rlg)"/></svg><div class="bd-arc" style="position:absolute;inset:0;pointer-events:none"><svg width="100%" height="100%" viewBox="0 0 1280 720"><defs><linearGradient id="rll" x1="0" y1="0" x2="1" y2="0"><stop offset="0" stop-color="__ACCENT__" stop-opacity=".16"/><stop offset=".5" stop-color="__ACCENT__" stop-opacity=".42"/><stop offset="1" stop-color="__ACCENT__" stop-opacity=".16"/></linearGradient><filter id="rllb"><feGaussianBlur stdDeviation="1.2"/></filter></defs><path d="M-80 8 C 300 2,980 2,1360 8" fill="none" stroke="url(#rll)" stroke-width="1.8" filter="url(#rllb)"/><path d="M-80 8 C 300 2,980 2,1360 8" fill="none" stroke="url(#rll)" stroke-width=".8"/></svg></div>
+     任意 styles/<skin>/。高光边线离顶边 24–32px(贴着顶边 2–8px 时读起来像没对齐的边框),
+     透明度 __LINE_ALPHA__ 由 html2pptx 按强调色亮度填(白色/浅色强调色调低,深色保持)。 -->
+<svg width="1280" height="720" viewBox="0 0 1280 720" style="position:absolute;inset:0;pointer-events:none"><defs><linearGradient id="rlg" x1="0" y1="0" x2="0" y2="1"><stop offset="0" stop-color="__ACCENT__" stop-opacity=".22"/><stop offset=".16" stop-color="__ACCENT__" stop-opacity=".08"/><stop offset=".38" stop-color="__ACCENT__" stop-opacity="0"/></linearGradient></defs><rect width="1280" height="720" fill="url(#rlg)"/></svg><div class="bd-arc" style="position:absolute;inset:0;pointer-events:none;opacity:__LINE_ALPHA__"><svg width="100%" height="100%" viewBox="0 0 1280 720"><defs><linearGradient id="rll" x1="0" y1="0" x2="1" y2="0"><stop offset="0" stop-color="__ACCENT__" stop-opacity=".16"/><stop offset=".5" stop-color="__ACCENT__" stop-opacity=".42"/><stop offset="1" stop-color="__ACCENT__" stop-opacity=".16"/></linearGradient><filter id="rllb"><feGaussianBlur stdDeviation="1.2"/></filter></defs><path d="M-80 32 C 300 24,980 24,1360 32" fill="none" stroke="url(#rll)" stroke-width="1.8" filter="url(#rllb)"/><path d="M-80 32 C 300 24,980 24,1360 32" fill="none" stroke="url(#rll)" stroke-width=".8"/></svg></div>

package/skills/document/styles/_contract-defaults.css

@@ -28,7 +28,7 @@
    `.cmp-col` 规则里定了边（同特异性、位置在后），仍然赢过兜底。
    改完必须重跑 `node scripts/deck/deck-fidelity.mjs`（它现在会注入本文件，此前不注入，
    所以这个文件曾经完全在像素闸门的视野之外），并按
-   `.claude/skills/ppt-tpl-prod/SKILL.md`"改 _contract-defaults.css"一节做
+   `docs/ppt-template-tooling.md`"改 _contract-defaults.css"一节做
    注入/不注入的对照渲染 —— deck-fidelity 的 32x18 签名对这类细微改动不够敏感。 */
 
 /* compare */
@@ -77,3 +77,8 @@
 .gantt-bar{background:var(--c1)}
 .map-pin{background:var(--accent)}
 .ring-fill{stroke:var(--accent)}
+/* 可阅读型内容页(2026-10-09):标题下的口径/副标题行与页底的「启示」条。新选择器,
+   没有任何现役皮肤定义它们;槽位为空时整块不渲染,不改变既有版式的观感。 */
+.deck-subhead{color:var(--muted)}
+.deck-takeaway{color:var(--title);border-left:3px solid var(--accent)}
+.deck-subhead:empty,.deck-takeaway:empty{display:none}

package/skills/document/styles/mckinsey/backdrop.html

@@ -1,5 +1,7 @@
-<!-- signature: the consulting binder — a solid top rule with a file-tab stub, the
-     four-piece chrome deck-design.md calls the strongest "consulting-grade" signal. -->
-<div style="position:absolute;left:0;right:0;top:0;height:5px;background:var(--accent);opacity:.92;pointer-events:none"></div>
-<div style="position:absolute;left:0;top:0;width:60px;height:16px;background:var(--accent);pointer-events:none"></div>
-<div style="position:absolute;right:56px;top:34px;bottom:34px;width:1px;background:var(--hair);pointer-events:none"></div>
+<!-- signature: a soft accent glow from the top-right corner over white, a faint grey
+     vignette at the foot — nothing else.
+     2026-10-09 (user's call): replaces the consulting-binder chrome this skin carried
+     since 7306d8e5 (a 5px full-width top rule, a 60×16 file-tab stub, a right-edge
+     hairline). The glow is the 2026-07-22 shared backdrop's, without its two bottom
+     curves. A deliberate change to the frozen classic-v1 look of original-13. -->
+<svg width="1280" height="720" viewBox="0 0 1280 720" style="position:absolute;inset:0;pointer-events:none" preserveAspectRatio="none"><defs><radialGradient id="bsg" cx="86%" cy="6%" r="54%"><stop offset="0" stop-color="__ACCENT__" stop-opacity=".16"/><stop offset="1" stop-color="__ACCENT__" stop-opacity="0"/></radialGradient></defs><rect width="1280" height="720" fill="url(#bsg)"/></svg><div style="position:absolute;inset:0;background:radial-gradient(130% 92% at 50% 128%,rgba(127,127,127,.10),transparent 46%);pointer-events:none"></div>

package/skills/grill-me/SKILL.md

@@ -0,0 +1,6 @@
+---
+name: grill-me
+description: A relentless interview to sharpen a plan or design.
+---
+
+Call load_skill with name "grilling".

package/skills/grill-me/agents/openai.yaml

@@ -0,0 +1,5 @@
+interface:
+  display_name: "Grill Me"
+  short_description: "Sharpen a plan through interview"
+policy:
+  allow_implicit_invocation: false

package/skills/grilling/SKILL.md

@@ -0,0 +1,28 @@
+---
+name: grilling
+description: Grill the user relentlessly about a plan, decision, or idea. Use when the user wants to stress-test their thinking, or uses any 'grill' trigger phrases.
+---
+
+Interview the user relentlessly until you reach a shared understanding. Map this as a **design tree**: every decision branches into the decisions that hang off it.
+
+Work the tree in **rounds**. The **frontier** is every decision whose prerequisites are already settled: the questions you can ask _now_ without guessing at answers you haven't heard yet. Ask the whole frontier in one round: number each question and give your recommended answer. Then wait for the user's answers before the next round.
+
+Format a round like so:
+
+```
+❓ **Q1** - **<question title>**: <question body, might be multiple paragraphs, including multiple choices>
+
+➡️ <your recommended answer>
+
+---
+
+❓ **Q2** - **<question title>**: <question body, might be multiple paragraphs, including multiple choices>
+
+➡️ <your recommended answer>
+```
+
+Each round the user answers reshapes the tree: settled decisions push the frontier outward and unblock questions that depended on them. Recompute the frontier and ask the next round. A question whose answer depends on another question still open in this round belongs to a _later_ round, not this one.
+
+Finding _facts_ is your job, never the user's. When a frontier question needs a fact from the environment (filesystem, tools, etc.), dispatch a sub-agent to find it; don't ask the user for anything you could look up yourself. Don't block on it: a running exploration is an unsettled prerequisite, so only the questions downstream of it wait for the sub-agent to report; ask the rest of the frontier now. The _decisions_ are the user's: put each to them and wait.
+
+The session is done when the frontier is empty: every branch of the design tree visited, nothing left silently assumed. Do not act on it until the user confirms you have reached a shared understanding.

package/skills/grilling/agents/openai.yaml

@@ -0,0 +1,3 @@
+interface:
+  display_name: "Grilling"
+  short_description: "Stress-test thinking a round of questions at a time"