@namewta/speculo 0.1.20 → 0.2.0

package/template/vendor/codebase-design/DESIGN-IT-TWICE.md

@@ -1,44 +0,0 @@
-# 设计两次（Design It Twice）
-
-当用户想要为选定的深化候选探索替代接口时，使用此并行子代理模式。基于"设计两次"（Ousterhout）——你的第一个想法不太可能是最好的。
-
-使用 [SKILL.md](SKILL.md) 中的术语——**module（模块）**、**interface（接口）**、**seam（接缝）**、**adapter（适配器）**、**leverage（杠杆）**。
-
-## 流程
-
-### 1. 界定问题空间
-
-在生成子代理之前，为选定候选编写面向用户的问题空间说明：
-
-- 任何新接口需要满足的约束
-- 它将依赖的依赖项，以及它们属于哪个类别（参见 [DEEPENING.md](DEEPENING.md)）
-- 一个粗略的说明性代码草图，用于将约束具体化——不是提案，只是将约束变得具体的方式
-
-将此展示给用户，然后立即进入第 2 步。用户在子代理并行工作时阅读和思考。
-
-### 2. 生成子代理
-
-使用 Agent 工具并行生成 3 个以上的子代理。每个子代理必须为深化后的模块生成一个**截然不同**的接口。
-
-为每个子代理提供一个单独的技术概要（文件路径、耦合细节、来自 [DEEPENING.md](DEEPENING.md) 的依赖类别、接缝背后的内容）。该概要独立于第 1 步中面向用户的问题空间说明。给每个代理不同的设计约束：
-
-- 代理 1："最小化接口——目标是最多 1–3 个入口点。最大化每个入口点的杠杆效应。"
-- 代理 2："最大化灵活性——支持多种用例和扩展。"
-- 代理 3："针对最常见调用方优化——让默认情况变得简单。"
-- 代理 4（如适用）："围绕端口与适配器设计跨接缝依赖。"
-
-在概要中同时包含 [SKILL.md](SKILL.md) 词汇和 CONTEXT.md 词汇，以便每个子代理在命名时与架构语言和项目的领域语言保持一致。
-
-每个子代理输出：
-
-1. 接口（类型、方法、参数——加上不变量、排序、错误模式）
-2. 使用示例，展示调用方如何使用
-3. 实现隐藏在接缝背后的内容
-4. 依赖策略和适配器（参见 [DEEPENING.md](DEEPENING.md)）
-5. 权衡——杠杆效应高的地方，薄弱的地方
-
-### 3. 展示与比较
-
-依次展示设计，以便用户逐一消化，然后用文字进行比较。通过**深度**（接口层面的杠杆效应）、**局部性**（变更集中的位置）和**接缝位置**进行对比。
-
-比较后，给出你自己的推荐：你认为哪个设计最强以及为什么。如果来自不同设计的元素可以很好地组合，提出一个混合方案。要有明确的观点——用户想要的是一个强有力的解读，而不是一份菜单。

package/template/vendor/codebase-design/SKILL.md

@@ -1,114 +0,0 @@
----
-name: codebase-design
-description: 设计深层模块的共享词汇。适用于用户想要设计或改进模块接口、寻找深化机会、决定接缝位置、使代码更可测试或对 AI 更可导航，或其他技能需要深层模块词汇的场景。
----
-
-# 代码库设计
-
-设计**深层模块**：大量行为隐藏在小型接口之后，放置在清晰的接缝处，通过该接口可测试。在任何设计或重构代码的地方使用这套语言和原则。目标是为调用者提供杠杆，为维护者提供局部性，为所有人提供可测试性。
-
-## 词汇表
-
-严格使用这些术语——不要替换为"组件"、"服务"、"API"或"边界"。一致的语言是全部要点。
-
-**模块**——任何有接口和实现的东西。刻意与规模无关：一个函数、类、包或跨层切片。*避免*：单元、组件、服务。
-
-**接口**——调用者正确使用模块必须知道的一切：类型签名，还有不变量、排序约束、错误模式、所需配置和性能特征。*避免*：API、签名（太窄——它们仅指向类型层面的表面）。
-
-**实现**——模块内部的内容，其代码体。区别于**适配器**：一个东西可以是一个小适配器带大实现（一个 Postgres 仓库）或一个大适配器带小实现（一个内存假对象）。当接缝是主题时用"适配器"；否则用"实现"。
-
-**深度**——接口处的杠杆：调用者（或测试）每学习单位接口能运用的行为量。一个模块是**深的**，当大量行为隐藏在小型接口之后；是**浅的**，当接口几乎和实现一样复杂。
-
-**接缝** *(Michael Feathers)*——一个可以在不编辑该处的情况下改变行为的地方；模块接口所在的*位置*。接缝放在哪里是其自身的设计决策，区别于接缝后面是什么。*避免*：边界（被 DDD 的有界上下文过载）。
-
-**适配器**——在接缝处满足接口的具体事物。描述*角色*（它填补哪个槽位），而非实质（里面是什么）。
-
-**杠杆**——调用者从深度中获得的东西：每学习单位接口获得更多能力。一个实现付出，在 N 个调用点和 M 个测试中获得回报。
-
-**局部性**——维护者从深度中获得的东西：变更、bug、知识和验证集中在一处，而不是分散在调用者中。一处修复，处处修复。
-
-## 深 vs 浅
-
-**深层模块** = 小接口 + 大量实现：
-
-```
-┌─────────────────────┐
-│   小型接口          │  ← 少数方法，简单参数
-├─────────────────────┤
-│                     │
-│   深层实现          │  ← 复杂逻辑隐藏
-│                     │
-└─────────────────────┘
-```
-
-**浅层模块** = 大接口 + 少量实现（应避免）：
-
-```
-┌─────────────────────────────────┐
-│       大型接口                  │  ← 许多方法，复杂参数
-├─────────────────────────────────┤
-│  薄实现                         │  ← 只是传递
-└─────────────────────────────────┘
-```
-
-设计接口时，问：
-
-- 我能减少方法数量吗？
-- 我能简化参数吗？
-- 我能隐藏更多复杂性在内部吗？
-
-## 原则
-
-- **深度是接口的属性，而非实现的属性。** 一个深层模块可以在内部由小型、可 mock、可替换的部件组成——它们只是不是接口的一部分。一个模块可以有**内部接缝**（对其实现私有，由其自己的测试使用）以及其接口处的**外部接缝**。
-- **删除测试。** 想象删除该模块。如果复杂性消失，它就是个传递。如果复杂性在 N 个调用者中重新出现，它就在赚取它的价值。
-- **接口就是测试表面。** 调用者和测试跨越同一接缝。如果你想测试到接口*之外*，模块的形状可能不对。
-- **一个适配器意味着假设的接缝。两个适配器意味着真实的接缝。** 除非某物确实在接缝处变化，否则不要引入接缝。
-
-## 为可测试性设计
-
-好的接口使测试变得自然：
-
-1. **接受依赖，而非创建依赖。**
-
-   ```typescript
-   // 可测试
-   function processOrder(order, paymentGateway) {}
-
-   // 难以测试
-   function processOrder(order) {
-     const gateway = new StripeGateway();
-   }
-   ```
-
-2. **返回结果，而非产生副作用。**
-
-   ```typescript
-   // 可测试
-   function calculateDiscount(cart): Discount {}
-
-   // 难以测试
-   function applyDiscount(cart): void {
-     cart.total -= discount;
-   }
-   ```
-
-3. **小表面积。** 更少的方法 = 需要更少的测试。更少的参数 = 更简单的测试设置。
-
-## 关系
-
-- 一个**模块**有且仅有一个**接口**（它呈现给调用者和测试的表面）。
-- **深度**是**模块**的属性，对照其**接口**来衡量。
-- **接缝**是模块**接口**所在之处。
-- **适配器**位于**接缝**处并满足**接口**。
-- **深度**为调用者产生**杠杆**，为维护者产生**局部性**。
-
-## 拒绝的框架
-
-- **深度为实现行数与接口行数之比**（Ousterhout）：奖励填充实现。我们改用深度作为杠杆。
-- **"接口"作为 TypeScript `interface` 关键字或类的公共方法**：太窄——这里的接口包括调用者必须知道的每个事实。
-- **"边界"**：被 DDD 的有界上下文过载。说**接缝**或**接口**。
-
-## 深入探索
-
-- **给定依赖深化一个集群**——参见 [DEEPENING.md](DEEPENING.md)：依赖类别、接缝规范和替换而非分层的测试。
-- **探索替代接口**——参见 [DESIGN-IT-TWICE.md](DESIGN-IT-TWICE.md)：启动并行子代理以几种截然不同的方式设计接口，然后比较深度、局部性和接缝位置。

package/template/vendor/officecli/SKILL.md

@@ -1,415 +0,0 @@
----
-name: officecli
-description: Create, analyze, proofread, and modify Office documents (.docx, .xlsx, .pptx) using the officecli CLI tool. Use when the user wants to create, inspect, check formatting, find issues, add charts, or modify Office documents.
----
-
-# officecli
-
-AI-friendly CLI for .docx, .xlsx, .pptx. Single binary, no dependencies, no Office installation needed.
-
-## Install
-
-If `officecli` is not installed:
-
-```bash
-# macOS / Linux
-curl -fsSL https://d.officecli.ai/install.sh | bash
-
-# Windows (PowerShell)
-irm https://d.officecli.ai/install.ps1 | iex
-```
-
-Verify with `officecli --version`. If still not found after install, open a new terminal.
-
----
-
-## Strategy
-
-**L1 (read) → L2 (DOM edit) → L3 (raw XML)**. Always prefer higher layers. Add `--json` for structured output.
-
-**Before doc work, check Specialized Skills** (bottom of this file). Fundraising decks, academic papers, financial models, dashboards, and Morph animations need their own skill loaded first — `load_skill` once, then proceed.
-
----
-
-## Help System (IMPORTANT)
-
-**When unsure about property names, value formats, or command syntax, ALWAYS run help instead of guessing.** One help query beats guess-fail-retry loops.
-
-`officecli help` ≡ `officecli --help`, and `officecli <cmd> --help` ≡ `officecli help <cmd>` — same content.
-
-```bash
-officecli help                                  # All commands + global options + schema entry points
-officecli help docx                             # List all docx elements
-officecli help docx paragraph                   # Full schema: properties, aliases, examples, readbacks
-officecli help docx set paragraph               # Verb-filtered: only props usable with `set`
-officecli help docx paragraph --json            # Structured schema (machine-readable)
-```
-
-Format aliases: `word`→`docx`, `excel`→`xlsx`, `ppt`/`powerpoint`→`pptx`. Verbs: `add`, `set`, `get`, `query`, `remove`. MCP exposes the same schema via `{"command":"help","format":"docx","type":"paragraph"}`.
-
----
-
-## Performance: Resident Mode
-
-**Every command auto-starts a resident on first access** (60s idle timeout) — file-lock conflicts are automatically avoided. Explicit `open`/`close` is still recommended for longer sessions (12min idle):
-```bash
-officecli open report.docx       # explicitly keep in memory
-officecli set report.docx ...    # no file I/O overhead
-officecli close report.docx      # save and release
-```
-
-Opt out of auto-start: `OFFICECLI_NO_AUTO_RESIDENT=1`.
-
----
-
-## Quick Start
-
-**PPT:**
-```bash
-officecli create slides.pptx
-officecli add slides.pptx / --type slide --prop title="Q4 Report" --prop background=1A1A2E
-officecli add slides.pptx '/slide[1]' --type shape --prop text="Revenue grew 25%" --prop x=2cm --prop y=5cm --prop font=Arial --prop size=24 --prop color=FFFFFF
-```
-
-**Word:**
-```bash
-officecli create report.docx
-officecli add report.docx /body --type paragraph --prop text="Executive Summary" --prop style=Heading1
-officecli add report.docx /body --type paragraph --prop text="Revenue increased by 25% year-over-year."
-```
-
-**Excel:**
-```bash
-officecli create data.xlsx
-officecli set data.xlsx /Sheet1/A1 --prop value="Name" --prop bold=true
-officecli set data.xlsx /Sheet1/A2 --prop value="Alice"
-```
-
----
-
-## L1: Create, Read & Inspect
-
-```bash
-officecli create <file>               # Create blank .docx/.xlsx/.pptx (type from extension)
-officecli view <file> <mode>          # outline | stats | issues | text | annotated | html
-officecli get <file> <path> --depth N # Get a node and its children [--json]
-officecli query <file> <selector>     # CSS-like query
-officecli validate <file>             # Validate against OpenXML schema
-```
-
-### view modes
-
-| Mode | Description | Useful flags |
-|------|-------------|-------------|
-| `outline` | Document structure | |
-| `stats` | Statistics (pages, words, shapes) | |
-| `issues` | Formatting/content/structure problems | `--type format\|content\|structure`, `--limit N` |
-| `text` | Plain text extraction | `--start N --end N`, `--max-lines N` |
-| `annotated` | Text with formatting annotations | |
-| `html` | Static HTML snapshot — same renderer as `watch`, no server needed | `--browser`, `--page N` (docx), `--start N --end N` (pptx) |
-| `screenshot` / `svg` / `pdf` / `forms` | PNG via headless browser / SVG (pptx slide) / PDF via exporter plugin / form-fields JSON via format-handler plugin | `-o`, `--screenshot-width/-height`, pptx `--grid N` |
-
-Use `view html` for one-shot snapshots (CI artifacts, archival, diffing); use `watch` when you need live refresh or browser-side click-to-select.
-
-### get
-
-Any XML path via element localName. Use `--depth N` to expand children. Add `--json` for structured output. Default text output is grep-friendly: `path (type) "text" key=val key=val ...`
-
-```bash
-officecli get report.docx '/body/p[3]' --depth 2 --json
-officecli get slides.pptx '/slide[1]' --depth 1          # list all shapes on slide 1
-officecli get data.xlsx '/Sheet1/B2' --json
-```
-
-### Stable ID Addressing
-
-Elements with stable IDs return `@attr=value` paths instead of positional indices. Prefer these in multi-step workflows — positional indices shift on insert/delete, stable IDs do not.
-
-```
-/slide[1]/shape[@id=550950021]                    # PPT shape
-/slide[1]/table[@id=1388430425]/tr[1]/tc[2]       # PPT table
-/body/p[@paraId=1A2B3C4D]                         # Word paragraph
-/comments/comment[@commentId=1]                    # Word comment
-```
-
-PPT also accepts `@name=` (e.g. `shape[@name=Title 1]`), with morph `!!` prefix awareness. Elements without stable IDs (slide, run, tr/tc, row) fall back to positional indices.
-
-### query
-
-CSS-like selectors: `[attr=value]`, `[attr!=value]`, `[attr~=text]`, `[attr>=value]`, `[attr<=value]`, `:contains("text")`, `:empty`, `:has(formula)`, `:no-alt`. Boolean `and`/`or` supported across `query`/`set`/`remove`: `cell[value>5000 or value<100]`, `cell[(type=Number or type=Date) and value>0]`. Excel row-by-column-name: `Sheet1!row[Salary>5000]`. `set` accepts selectors and Excel-native paths (parity with `get`/`query`). Bare unscoped selectors rejected on `set`/`remove`.
-
-```bash
-officecli query report.docx 'paragraph[style=Normal] > run[font!=Arial]'
-officecli query slides.pptx 'shape[fill=FF0000]'
-```
-
----
-
-## Watch & Interactive Selection
-
-Live HTML preview that auto-refreshes on every file change. Browsers can click / shift-click / box-drag to select shapes; the CLI can read the current browser selection and act on it.
-
-```bash
-officecli watch <file> [--port N]      # Start preview server (default port 26315)
-officecli unwatch <file>               # Stop
-officecli goto <file> <path>           # Scroll watching browser(s) to element (docx: p / table / tr / tc)
-```
-
-Open the printed `http://localhost:N` URL. Click to select; shift/cmd/ctrl+click to multi-select; drag from empty space to box-select. PPT/Word use blue outline; Excel uses native-style green selection (double-click cell to edit inline; drag a chart to reposition).
-
-### `get <file> selected` — read what the user clicked
-
-```bash
-officecli get <file> selected [--json]
-```
-
-Returns DocumentNodes for whatever is currently selected. Empty result if nothing selected. Exit code != 0 if no watch is running.
-
-```bash
-# User clicks shapes in the browser, then asks "make these red"
-PATHS=$(officecli get deck.pptx selected --json | jq -r '.data.Results[].path')
-for p in $PATHS; do officecli set deck.pptx "$p" --prop fill=FF0000; done
-```
-
-### Key properties
-
-- **Selection survives file edits.** Paths use stable `@id=` form.
-- **All connected browsers share one selection.** Last-write-wins.
-- **Same-file single-watch.** A given file can have only one watch process at a time.
-- **Group shapes select as a whole.** Drilling into individual children of a group is not supported in v1.
-- **Coverage:** `.pptx` shapes/pictures/tables/charts/connectors/groups; `.docx` top-level paragraphs and tables. Inherited layout/master decorations and Word nested elements (table cells, run-level) are not addressable. **`.xlsx` does not emit `data-path`** — `mark`/`selection` on xlsx always resolve `stale=true` (v2 candidate).
-
-### Marks — edit proposals waiting for review
-
-Use `mark` when changes need human review BEFORE they hit the file. Marks live in the watch process only; a separate `set` pipeline applies accepted ones. For one-shot changes use `set` directly; for permanent file annotations use `add --type comment` (Word native).
-
-```bash
-officecli mark <file> <path> [--prop find=... color=... note=... tofix=... regex=true] [--json]
-officecli unmark <file> [--path <p> | --all] [--json]
-officecli get-marks <file> [--json]
-```
-
-Props: `find` (literal or regex when `regex=true`; raw form `find='r"[abc]"'`), `color` (hex / `rgb(...)` / 22 named whitelist), `note`, `tofix` (drives apply pipeline). **Path** must be `data-path` format from watch HTML — see subskills for full pipeline.
-
----
-
-## L2: DOM Operations
-
-### set — modify properties
-
-```bash
-officecli set <file> <path> --prop key=value [--prop ...]
-```
-
-**Any XML attribute is settable** via element path (found via `get --depth N`) — even attributes not currently present. Without `find=`, `set` applies format to the entire element.
-
-**Value formats:**
-
-| Type | Format | Examples |
-|------|--------|---------|
-| Colors | Hex (with/without `#`), named, RGB, theme | `FF0000`, `#FF0000`, `red`, `rgb(255,0,0)`, `accent1`..`accent6` |
-| Spacing | Unit-qualified | `12pt`, `0.5cm`, `1.5x`, `150%` |
-| Dimensions | EMU or suffixed | `914400`, `2.54cm`, `1in`, `72pt`, `96px` |
-
-**Dotted-attr aliases** — `font.<attr>` forms accepted on shape/run/paragraph/table/row/cell/section/styles, e.g. `--prop font.color=red --prop font.bold=true --prop font.size=14pt`. Run `officecli help <fmt> <element>` for the full list.
-
-### find — format or replace matched text
-
-Use top-level `--find` / `--replace` on `set` (and `--find` on `query`). Legacy `--prop find=X` still works but emits a hint.
-
-```bash
-# Format matched text (auto-splits runs)
-officecli set doc.docx '/body/p[1]' --find weather --prop bold=true --prop color=red
-
-# Regex matching (regex= still a prop flag)
-officecli set doc.docx '/body/p[1]' --find '\d+%' --prop regex=true --prop color=red
-
-# Replace text (use `/` for whole-document scope)
-officecli set doc.docx / --find draft --replace final
-
-# docx: tracked Find&Replace
-officecli set doc.docx / --find draft --replace final --prop revision.author=Alice
-
-# PPT — same syntax, different paths
-officecli set slides.pptx / --find draft --replace final
-```
-
-**Path controls search scope:** `/` = whole document, `/body/p[1]` or `/slide[N]/shape[M]` = specific element, `/header[1]` / `/footer[1]` = headers/footers.
-
-**Notes:**
-- Case-sensitive by default. Case-insensitive: `--prop 'find=(?i)error' --prop regex=true`
-- Matches work across run boundaries
-- No match = silent success. `--json` includes `"matched": N`
-- **Excel:** only `find` + `replace` supported (no find + format props)
-
-### add — add elements or clone
-
-```bash
-officecli add <file> <parent> --type <type> [--prop ...]
-officecli add <file> <parent> --type <type> --after <path> [--prop ...]   # insert after anchor
-officecli add <file> <parent> --type <type> --before <path> [--prop ...]  # insert before anchor
-officecli add <file> <parent> --type <type> --index N [--prop ...]        # 0-based position (legacy)
-officecli add <file> <parent> --from <path>                               # clone existing element
-```
-
-`--after`, `--before`, `--index` are mutually exclusive. No position flag = append to end.
-
-**Element types (with aliases):**
-
-| Format | Types |
-|--------|-------|
-| **pptx** | slide (incl. hidden), shape (font.latin/ea/cs, direction=rtl, underline.color, highlight=COLOR (Add/Set/Get/HTML preview), effective.X+effective.X.src; arrow alias for rightArrow; slideMaster/slideLayout typed add/set/remove), picture (SVG, brightness/contrast/glow/shadow, rotation, link, tooltip), chart (direction=rtl, pieOfPie, barOfPie, axisLine/gridline per-attr setters, animation+chartBuild=byCategory|bySeries, line dropLines/hiLowLines/upDownBars, anchor=x,y,w,h shorthand), table (cell direction=rtl, fill/background, built-in PowerPoint style catalogue, /col[C] get + swap/copyFrom, row/col Move/CopyFrom), row (tr), connector (from/to accept @name=, startshape/endshape SetByPath), group (link, tooltip, deep walk by get/query/add/remove), video/audio (loop, autoStart alias), equation, notes (direction=rtl, lang), comment (legacy + modern p188 threaded round-trip), animation (15 emphasis + 16 exit presets, multi-effect chains, motion-path presets, repeat/restart/autoReverse, chart animations), transition (12 p15 presets + morph/p14), paragraph (para), run, zoom, ole (preview=, full dump round-trip via add-part+raw-set), placeholder (phType=...), model3d (rotation=ax,ay,az; full dump round-trip), smartart (dump round-trip via add-part). |
-| **docx** | paragraph (direction/font.latin/ea/cs, bold.cs/italic.cs/size.cs, lang.latin/ea/cs, wordWrap, framePr.\*, tabs shorthand), run (lang slots, direction, underline.color, position half-pts, **revision.type=ins\|del\|format\|moveFrom\|moveTo + revision.action=accept\|reject** with .author/.date — `/revision[@author=X]` selector for filtered accept/reject), table (direction=rtl, hMerge, **virtual column ops**: add/remove/move/copyfrom on /body/tbl[N]/col), row (tr), cell (td), image, header/footer (direction), section (pageNumFmt full enum, direction=rtl, rtlGutter, pgBorders=box), bookmark, comment, footnote, endnote, formfield, sdt, chart, equation, field (28 types), hyperlink, style (direction, indents, pbdr, lineSpacing on Add/Set), toc, watermark, break, ole, **num/abstractNum/lvl**, **tab**, **textbox/shape** (full Add+Get; geometry, fill, line, wrap, alt, anchor, **rotation, verticalText (eaVert/vert/vert270/wordArt\*), gradient, shadow, opacity**), embedded **OLE round-trip on dump→batch**. docDefaults.rtl, autoHyphenation, `get /` exposes locale + /comments /footnotes /endnotes. `create --minimal` for raw OOXML scaffolding. |
-| **xlsx** | sheet (visible/hidden/veryHidden, print margins, printTitleRows/Cols, rightToLeft sheetView, cascade-aware rename), row (c{N}= cell-content shorthand; add accepts --from /Sheet/col[L]; formula-ref rewrite on insert), col (formula-ref rewrite, named-range follow on move), cell (type=richtext+runs, merge=range/sweep, direction=rtl, phonetic; **--shift left\|up on remove, shift=right\|down on add** — Excel UI dialog parity; formula auto-detect; OFFSET/INDIRECT in calc), chart (per-axis RTL/title, anchor=x,y,w,h, pareto), image (SVG), comment (direction=rtl), table (listobject), namedrange (definedname, volatile, `[@name=X]`; formula-body inlined at parse), pivottable (cache CoW + cross-pivot sharing, labelFilter, topN, fillDownLabels, calculatedField), sparkline, validation, autofilter, shape, textbox, CF (databar/colorscale/iconset/formulacf/cellIs/topN/aboveAverage), ole, csv. Query supports `merge`/`mergedrange`. Workbook: password. Shape selector enumerates leaves inside grpSp. |
-
-### Pivot tables (xlsx)
-
-```bash
-officecli add data.xlsx /Sheet1 --type pivottable \
-  --prop source="Sheet1!A1:E100" --prop rows=Region,Category \
-  --prop cols=Year --prop values="Sales:sum,Qty:count" \
-  --prop grandTotals=rows --prop subtotals=off --prop sort=asc
-```
-
-Key props: `rows`, `cols`, `values` (Field:func[:showDataAs]), `filters`, `source`, `position`, `layout` (compact/outline/tabular), `repeatLabels`, `blankRows`, `aggregate`, `showDataAs` (percent_of_total/row/col, running_total), `grandTotals`, `subtotals`, `sort`. Aggregators: sum, count, average, max, min, product, stdDev, stdDevp, var, varp, countNums. Date columns auto-group. Run `officecli help xlsx pivottable` for full schema.
-
-### Document-level properties (all formats)
-
-```bash
-officecli set doc.docx / --prop docDefaults.font=Arial --prop docDefaults.fontSize=11pt
-officecli set doc.docx / --prop protection=forms --prop evenAndOddHeaders=true
-officecli set data.xlsx / --prop calc.mode=manual --prop calc.refMode=r1c1
-officecli set slides.pptx / --prop defaultFont=Arial --prop show.loop=true --prop print.what=handouts
-```
-
-Run `officecli help <format> /` for all document-level properties (docDefaults, docGrid, CJK spacing, calc, print, show, theme, extended).
-
-### Sort (xlsx)
-
-```bash
-officecli set data.xlsx /Sheet1 --prop sort="C desc" --prop sortHeader=true
-officecli set data.xlsx '/Sheet1/A1:D100' --prop sort="A asc" --prop sortHeader=true
-```
-
-Format: `COL DIR[, COL DIR ...]`. Rejects ranges with merged cells or formulas. Sidecar metadata (hyperlinks, comments, conditional formatting, drawings) follows rows automatically.
-
-### Text-anchored insert (`--after find:X` / `--before find:X`)
-
-Locate an insertion point by text match within a paragraph. Inline types (run, picture, hyperlink) insert within the paragraph; block types (table, paragraph) auto-split it. PPT only supports inline.
-
-```bash
-# Word: inline run after matched text
-officecli add doc.docx '/body/p[1]' --type run --after find:weather --prop text=" (sunny)"
-
-# Word: block table after matched text (auto-splits paragraph)
-officecli add doc.docx '/body/p[1]' --type table --after "find:First sentence." --prop rows=2 --prop cols=2
-```
-
-### Clone
-
-`officecli add <file> / --from '/slide[1]'` — copies with all cross-part relationships.
-
-### move, swap, remove
-
-```bash
-officecli move <file> <path> [--to <parent>] [--index N] [--after <path>] [--before <path>]
-officecli swap <file> <path1> <path2>
-officecli remove <file> '/body/p[4]'
-```
-
-When using `--after` or `--before`, `--to` can be omitted — the target container is inferred from the anchor.
-
-### batch — multiple operations in one save cycle
-
-Continues on error by default (returns exit 1 if any item fails). Use `--stop-on-error` to abort on the first failure. `--force` is the docx-protection bypass.
-
-`officecli dump <file> [<path>]` emits a replayable batch JSON for round-trip — `.docx` (full coverage) and `.pptx` (text/tables/pictures/charts/notes/theme + OLE/3D/video/audio/SmartArt/morph/p15 transitions via raw-set passthrough). Path defaults to `/` (whole document); pass a subtree path (`/body`, `/body/p[N]`, `/body/tbl[N]`, `/theme`, `/settings`, `/numbering`, `/styles`) to scope the dump. `officecli refresh <file.docx>` recalculates TOC page numbers / PAGE / cross-references after replay (Word backend on Windows; headless-HTML fallback elsewhere). `officecli plugins list` extends support to `.doc`, `.hwpx`, `.pdf` export.
-
-```bash
-echo '[
-  {"command":"set","path":"/Sheet1/A1","props":{"value":"Name","bold":"true"}},
-  {"command":"set","path":"/Sheet1/B1","props":{"value":"Score","bold":"true"}}
-]' | officecli batch data.xlsx --json
-
-officecli batch data.xlsx --commands '[{"op":"set","path":"/Sheet1/A1","props":{"value":"Done"}}]' --json
-officecli batch data.xlsx --input updates.json --force --json
-```
-
-Supports: `add`, `set`, `get`, `query`, `remove`, `move`, `swap`, `view`, `raw`, `raw-set`, `validate`. Fields: `command` (or `op`), `path`, `parent`, `type`, `from`, `to`, `index`, `after`, `before`, `props`, `selector`, `mode`, `depth`, `part`, `xpath`, `action`, `xml`.
-
----
-
-## L3: Raw XML
-
-Use when L2 cannot express what you need. No xmlns declarations needed — prefixes auto-registered.
-
-```bash
-officecli raw <file> <part>                          # view raw XML
-officecli raw-set <file> <part> --xpath "..." --action replace --xml '<w:p>...</w:p>'
-officecli add-part <file> <parent>                   # create new document part (returns rId)
-```
-
-`raw-set` actions: `append`, `prepend`, `insertbefore`, `insertafter`, `replace`, `remove`, `setattr`. Run `officecli help <format> raw` for available parts.
-
----
-
-## Common Pitfalls
-
-| Pitfall | Correct Approach |
-|---------|-----------------|
-| `--name "foo"` | Use `--prop name="foo"` — all attributes go through `--prop` |
-| Unquoted `[N]` paths in zsh/bash | Always quote: `'/slide[1]'` or `"/slide[1]"` (shell glob-expands brackets) |
-| PPT `shape[1]` for content | `shape[1]` is typically the title placeholder. Use `shape[2]+` for content shapes |
-| `/shape[myname]` | Name indexing not supported. Use numeric index or `@name=` (PPT only) |
-| Guessing property names | Run `officecli help <format> <element>` to see exact names |
-| Modifying an open file | Close the file in PowerPoint/WPS first |
-| `\n` in shell strings | Use `\\n` for newlines in `--prop text="..."` |
-| `$` in shell text | `--prop text="$15M"` strips `$15`. Use single quotes: `--prop text='$15M'`, or heredoc batch |
-
----
-
-## Specialized Skills
-
-`officecli load_skill <name>` — output is a SKILL.md, follow its rules.
-
-**Loading rule**:
-- Pick the most specific match in "When to use"; if none fits, load the format default (`word` / `pptx` / `excel`).
-- Scenes already contain the format default's rules — load **one** skill per artifact, never stack.
-- Loaded rules persist across turns; don't re-load each reply.
-- Two distinct artifacts → two separate loads.
-
-### Word (.docx)
-
-| Name | When to use |
-|------|-------------|
-| `word` | Reports, letters, memos, proposals, generic documents |
-| `academic-paper` | Journal / conference / thesis: APA / Chicago / IEEE / MLA citations, equations, SEQ + PAGEREF cross-refs, multi-column journal layout, bibliography. NOT for business reports or letters (route those to `word`) |
-
-### PowerPoint (.pptx)
-
-| Name | When to use |
-|------|-------------|
-| `pptx` | Generic decks: board reviews, sales decks, all-hands, product launches |
-| `pitch-deck` | **Fundraising only** — seed / Series A-C / SAFE / convertible / strategic raise. NOT for sales / product / board decks (route those to `pptx`) |
-| `morph-ppt` | Cinematic Morph-animated presentations. NOT for static decks (route those to `pptx`) |
-| `morph-ppt-3d` | 3D Morph: GLB models, camera moves, depth. NOT for 2D-only Morph (route those to `morph-ppt`) |
-
-### Excel (.xlsx)
-
-| Name | When to use |
-|------|-------------|
-| `excel` | Generic workbooks, formulas, pivots, trackers |
-| `financial-model` | Financial models, scenarios, projections. NOT for general data analysis (route those to `excel`) |
-| `data-dashboard` | CSV/tabular data → KPI / analytics / executive dashboards with charts and sparklines. NOT for raw data tracking (route those to `excel`) |
-
-Example: a fundraising deck task → `officecli load_skill pitch-deck` → use the printed rules.
-
----
-
-## Notes
-
-- Paths are **1-based** (XPath convention): `'/body/p[3]'` = third paragraph
-- `--index` is **0-based** (array convention): `--index 0` = first position
-- **Excel exception**: for `add --type row` and `add --type col`, `--index N` is **1-based** (matches OOXML RowIndex / column letter index). `--index 5` inserts at row 5 / column 5.
-- After modifications, verify with `validate` and/or `view issues`
-- **When unsure**, run `officecli help <format> <element>` instead of guessing

package/template/vendor/resolving-merge-conflicts/SKILL.md

@@ -1,14 +0,0 @@
----
-name: resolving-merge-conflicts
-description: "适用于需要解决进行中的 git merge/rebase 冲突的场景。"
----
-
-1. **查看当前状态**——merge/rebase 的当前状态。检查 git 历史以及冲突文件。
-
-2. **找到每个冲突的主要来源。** 深入理解每次更改的原因以及原始意图。阅读提交消息、查看 PR、查看原始 issue/工单。
-
-3. **解决每个冲突块。** 在可能的情况下保留两种意图。当不兼容时，选择与合并声明目标匹配的那个并注明权衡。**不要**发明新行为。始终解决；永远不要 `--abort`。
-
-4. 发现项目的**自动化检查**并运行它们——通常是类型检查，然后是测试，然后是格式化。修复合并破坏的任何内容。
-
-5. **完成 merge/rebase。** 暂存所有内容并提交。如果正在 rebase，继续 rebase 过程直到所有提交都被 rebase。