template-instantiator

Nothing says "an agent touched this" like a [X] in the delivered file. Or a {{name}}. Or lorem ipsum. Or "John Doe" in row 3.

交付文件里一个 [X] 就能出卖"这是 agent 弄的"。还有 {{name}}、lorem ipsum、第 3 行的 "John Doe"。

Why / 为什么

Templates carry two kinds of residue: the placeholders you can see, and the example content you stop seeing after the tenth read — sample rows that ship to clients, Acme Corp in the footer, last quarter's numbers in the "update this" cell. The skill's core is mechanical: inventory, replace, scan, show the zero.

模板带着两种残渣：看得见的占位符，和读到第十遍就看不见的示例内容——发给客户的样例行、页脚的 Acme Corp、"此处更新"格里上季度的数字。这个 skill 的核心是机械流程：盘点、替换、扫描、出示零残留证明。

The loop / 流程

1. Inventory — list every placeholder and variation in the template: {{var}}, {var}, [X], <placeholder>, TODO/FIXME/TBD, lorem ipsum, and the example rows the template shipped with.
2. Replace from stated data — each fill traces to user-provided data or an agreed source; a value that does not exist is a question for the user, never invented. Optional sections the user did not request get deleted, not left half-filled.
3. Scan — one mechanical pass for every inventory pattern across the final file; the pattern list came from step 1, so nothing is scanned-by-memory.
4. Show the zero — the scan result (patterns checked, hits found, hits resolved) is stated in the delivery note. A clean claim without the shown scan is an assumption.

Honest limitations / 如实说明局限

• The scan finds the patterns it inventoried; a placeholder style nobody listed escapes — the inventory step is the whole game.
• Filling legal or compliance templates needs domain review; "proven clean of residue" is not "correct".

扫描只能找到盘点过的模式；没列出的占位符样式会漏——盘点步骤就是全部。法律合规模板的填充需要领域审查；"无残留"不等于"正确"。

Install / 安装

npx skills add ChenneyZhuang/template-instantiator

Per-agent paths: COMPATIBILITY.md. MIT. v0.1.0.

各 agent 安装路径见 COMPATIBILITY.md。MIT 许可，v0.1.0。