@wwkit/harness 1.0.27 → 1.0.29

package/skills/revise/SKILL.md

@@ -1,10 +1,8 @@
 ---
 name: revise
 description: |
-  自包含内容创作 skill：每次调用 = 一个固定 Sprint——Sprint Planning（解析入参、定义 Sprint Goal、todowrite 落固定 Sprint Backlog）→ Sprint Execution（逐项执行并验证 DoD）→ Sprint Review（对照 Sprint Goal 校验交付 + 简要回顾）。
-  format=question/status/gallery/article。count 控制条目数（默认1），language 控制输出语言（默认中文）。
-  调用方直接传原始任务消息，skill 自解析自包含。内部用 todowrite 管理固定 6 项 Sprint Backlog（每项带 DoD）。禁止 WebFetch/网络请求。
-  适用：内容创作（question/status/gallery/article 等）。
+  自包含内容创作 skill（固定 Sprint 范式）：每次调用 = 一个固定 Sprint（Planning→Execution→Review），todowrite 落 3 项带 DoD 的 Sprint Backlog 并逐项验证，产出通过 schema 校验的 JSON 数组。
+  format=question/status/gallery/article（支持中文别名指定），count 控制条目数（默认1），language 控制输出语言（默认中文）。调用方直接传原始任务消息即可，无需预处理；禁止 WebFetch/网络请求。
 license: MIT
 metadata:
   workflow: sequential
@@ -16,136 +14,95 @@ metadata:
 
 每次调用 = 一个固定 Sprint，三个事件：
 
-1. **Sprint Planning**：解析入参 → 定义 Sprint Goal → todowrite 落固定 6 项 Sprint Backlog（每项带 DoD）
+1. **Sprint Planning**：解析入参 → 定义 Sprint Goal → todowrite 落固定 3 项 Sprint Backlog（每项带 DoD）
 2. **Sprint Execution**：逐项执行，每项 = 执行 → 验证 DoD → todowrite 勾单 Done
-3. **Sprint Review**：对照 Sprint Goal 验证 Increment（JSON 数组）及输出语义，沉淀 1 条回顾
+3. **Sprint Review**：对照 Sprint Goal 验证 Increment（JSON 数组）及输出语义
 
 **Sprint Goal** = `产出 {{count}} 条符合 {{format}} 格式、{{language}} 语言的 JSON 数组，并通过 schema 校验`。
 
 ## 输入参数
 
-入参为调用方传入的**原始任务消息**，可为 JSON 对象、key=value 或自然语言等任意形态，agent 依据字段语义自主提取（详见 Item 1）。字段清单（字段/类型/必填/默认值）以 `references/input.schema.json5` 为准：
+入参为调用方传入的**原始任务消息**，可为 JSON 对象、key=value 或自然语言等任意形态，agent 依据字段语义自主提取。字段清单（字段/类型/必填/默认值）：
 
 | 字段 | 类型 | 必填 | 说明 |
 |---|---|---|---|
-| `format` | string | ✅ | 创作格式，标准值 `question`/`status`/`gallery`/`article`，可由别名表翻译 |
+| `format` | string | ✅ | 创作格式，标准值 `question`/`status`/`gallery`/`article`，可用自然语言别名指定（见别名对照） |
 | `source` | string | ✅ | 原始素材：文本 / JSON 字符串 / 文件路径 |
-| `count` | integer | ❌ | 生成 item 数量，默认 1 |
-| `language` | string | ❌ | 输出内容语言，默认 中文 |
+| `count` | integer | ❌ | 生成 item 数量，默认 1（非整数或 <1 按 1） |
+| `language` | string | ❌ | 输出语言，默认 中文（空白按中文） |
+| `style` | string | ❌ | 创作风格描述（自由文本），缺省用 format 默认风格（`<format>.md` 的 Style 模块） |
 | `output` | string | ❌ | 输出文件路径（提供则写文件，否则 stdout） |
 
-本技能仅使用上表五个字段，忽略所有其他字段（如 `url`），不得读取、写入或据此推断任何行为。
+本技能仅使用上表六个字段，忽略所有其他字段（如 `url`）。
 
-## 固定 Sprint Backlog（todowrite 落单，覆盖历史 todos）
-
-1. 解析入参（从任意形态任务消息自主提取 format/source/count/language/output） | DoD: 得到五个字段值（或按短路规则输出 `[]`/错误并结束）
-2. 加载 references（format prompt 文件 + schema 文件） | DoD: `references/{{format}}.md` 与 `references/{{format}}.schema.json5` 已读取，schema 绝对路径已记录（或 format 无效时输出 `[]`）
-3. 内容生成（LLM 创作） | DoD: 产出含 `{{count}}` 个 item、`{{language}}` 语言的 JSON 数组
-4. Schema 校验 | DoD: `node validate-schema.js` 执行完成，返回通过/失败结果
-5. 校验失败修复重试（≤3 次） | DoD: 重试后校验通过，或重试 3 次耗尽后 stderr 输出错误
-6. 输出（写 output 文件或 stdout） | DoD: 按输出语义交付 JSON 数组（文件路径或 stdout），校验未通过时 stderr 报错
-
-## Sprint Execution
-
-按固定 6 项逐项执行，每项周期 = 进度检查（刚完成什么/本项做什么/有无阻塞）→ 执行 → 验证 DoD → 勾单 Done。
-
-### Item 1：解析入参
-
-将第 1 项标记 in_progress，从原始任务消息中**自主提取**五个字段。入参可为 JSON 对象、key=value 或自然语言等任意形态，依据字段语义理解提取即可，无需固定解析规则。提取原则：
-
-- **格式翻译**：若消息中以自然语言指定创作格式（如"问题/文章/图集/动态"），用 `read` 读取 `references/format-aliases.json5`，将命中的 `terms` 翻译为该 format 标准值；未命中则 `format` 取消息中明确给出的值。
-- **count/language**：缺省时留空，由 Item 3 统一按默认值处理。
-
-解析后得到 `format`、`source`、`count`、`language`、`output` 五个字段（字段说明见上文输入参数表）。
-
-**短路规则（按顺序执行，命中即结束）：**
+**format 别名对照**：
 
-1. **空 source 短路**：若 `source` 为空、null 或仅含空白：直接输出 `[]` 并结束，**禁止**继续执行。
-2. **format 缺失校验**：若 `format` 未提供或经别名表翻译后仍为空：将错误信息输出到 stderr 并结束，**禁止**继续执行。
+| format 标准值 | 别名 terms |
+|---|---|
+| `question` | 问题 / 提问 / 互动话题 / 话题 / question |
+| `status` | 动态 / 微博 / 朋友圈 / 状态 / 一句话 / status |
+| `gallery` | 图集 / 相册 / 多图 / 图片合集 / gallery |
+| `article` | 文章 / 图文 / 长文 / 推文 / article |
 
-**验证 DoD**：五个字段值已得到（或按短路规则结束）。通过后标记 Done。
-
-### Item 2：加载 Prompt 和 Schema
+## 固定 Sprint Backlog（todowrite 落单，覆盖历史 todos）
 
-将第 2 项标记 in_progress，从技能目录的 `references/` 加载对应格式的文件：
+1. 解析入参 + 准备素材 + 加载 references | DoD: 六字段已提取、素材已就绪（文件已读）、prompt 与 schema 已读且 schema 绝对路径已记录（或 stderr 报错结束）
+2. 内容生成 + Schema 校验（失败修复重试 ≤3 次） | DoD: 产出含 `{{count}}` 个 item、`{{language}}` 语言的裸 JSON 数组且 `node validate-schema.js` 校验通过（或重试耗尽 stderr 报错）
+3. 输出 | DoD: 按输出语义交付 JSON 数组（文件路径或 stdout）
 
-- Prompt 文件：`references/{{ format }}.md` — LLM 创作指令
-- Schema 文件：`references/{{ format }}.schema.json5` — 输出校验规则（JSON Schema）
+## Sprint Execution
 
-用 `read` 工具读取两个文件内容，并**记录 schema 文件的绝对路径**（Item 4 校验时需要）。若对应 references 文件不存在：直接输出 `[]` 并结束（`format` 缺失已在 Item 1 处理）。
+按固定 3 项逐项执行（勾单机制见执行范式）。
 
-**验证 DoD**：两个文件已读取、schema 绝对路径已记录（或 references 文件不存在已短路）。通过后标记 Done。
+### Item 1：解析入参 + 准备素材 + 加载 references
 
-### Item 3：内容生成
+从原始任务消息中自主提取 `format`/`source`/`count`/`language`/`style`/`output` 六个字段；自然语言格式按「format 别名对照」翻译。`source` 为文件路径时用 `read` 读取其内容作为素材。
 
-将第 3 项标记 in_progress，将 `source` 解析为素材。判断顺序：
+**短路规则（命中即结束，禁止继续执行）：**
 
-1. **文件路径**：`source` 为现有文件路径 → 用 `read` 读取文件内容作为素材；
-2. **JSON 字符串**：素材以 `{` 或 `[` 开头且可整体解析为 JSON → 解析为结构化对象作为素材；
-3. **否则**：素材作为纯文本字符串。
+1. `source` 为空、null 或仅含空白 → 将错误信息输出到 stderr 并结束
+2. `format` 未提供或经别名对照翻译后仍为空 → 将错误信息输出到 stderr 并结束
 
-**禁止用 bash 解析 JSON**，JSON 判断与解析直接依据文本内容理解完成。素材确定后，将素材结合 Prompt 文件内容调用 LLM 生成符合格式的结果。**必须生成 `{{ count }}` 个 item，整体输出为 JSON 数组（即使 count=1）。** 内容语言使用 `{{ language }}`（默认中文）。
+未短路时**并行读取** `references/{{format}}.md`（LLM 创作指令）与 `references/{{format}}.schema.json5`（输出校验规则），记录 schema 绝对路径（Item 2 校验用）；references 文件不存在 → 将错误信息输出到 stderr 并结束。
 
-`count` 缺省、非整数或小于 1 时按 1 处理；`language` 缺省或仅含空白时按 `中文` 处理。
+### Item 2：内容生成 + Schema 校验
 
-生成时向 LLM 传入：
-- 原始素材（完整 source，已解析为可读格式）
-- Prompt 文件内容（创作指令）
-- `{{ count }}`（生成 item 数量）
-- `{{ language }}`（输出语言）
-- 输出格式说明和示例
+将素材结合 Prompt 文件内容调用 LLM 生成：**必须生成 `{{count}}` 个 item，整体输出为 JSON 数组（即使 count=1）**，内容语言使用 `{{language}}`（缺省按参数表默认值）。生成时向 LLM 传入：原始素材、Prompt 文件内容、`{{count}}`、`{{language}}`、输出格式说明和示例。
 
-**验证 DoD**：已产出含 `{{count}}` 个 item、`{{language}}` 语言的 JSON 数组。通过后标记 Done。
+**style 覆盖**：若提供 `style`，以 `{{style}}` 取代 `<format>.md` 的 **Style 模块**（默认创作风格）；**Format 模块（输出契约）不可变**——结构、schema 字段、长度、图片数量上限、真实性约束均以 Format 模块与 schema 为准。
 
-### Item 4：Schema 校验
+**裸 JSON 硬约束**：输出必须为裸 JSON 数组——不使用 markdown 代码围栏（```json）、不输出任何解释、思考过程或额外文本、无尾注，直接以 `[` 开始、`]` 结束。
 
-将第 4 项标记 in_progress，用 `write` 工具将待校验的 JSON 数组写入临时文件，再用 `write` 工具将 `{"data": <JSON 数组>, "schema_path": "<schema 绝对路径>"}` 写入 JSON 输入文件，stdin 重定向交给 Node.js 校验：
+用 `write` 将 `{"data": <JSON 数组>, "schema_path": "<schema 绝对路径>"}` 写入**单个**临时 JSON 输入文件（数组内嵌于 `data`，无需单独写待校验数组文件），stdin 重定向交给 Node.js 校验：
 
 ```bash
 node '<技能目录>/references/validate-schema.js' < <临时 JSON 输入文件>
 ```
 
-- 若校验通过：**验证 DoD**（校验执行完成且返回通过），标记 Done，跳过 Item 5，进入 Item 6
-- 若校验失败：**验证 DoD**（校验执行完成且返回失败），标记 Done，进入 Item 5 进行修复重试（最多 3 次）
-
-### Item 5：校验失败时修复重试
-
-将第 5 项标记 in_progress，将错误信息反馈给 LLM，要求其根据原始素材重新生成。
+- 通过 → 进入 Item 3
+- 失败 → 将 Schema 校验错误反馈给 LLM（原始素材 + Prompt 文件内容 + 上一轮不合格内容 + 错误详情）重新生成后再次校验，**最多重试 3 次**；耗尽 → 将最后一次错误及「重试 3 次后 schema 校验仍然失败」输出到 stderr 并结束
 
-传入内容：
-- 原始素材（完整 source）
-- Prompt 文件内容
-- 上一轮生成的不合格内容
-- Schema 校验错误详情
+### Item 3：输出
 
-重新生成后，再次执行 Item 4 校验。**最多重试 3 次**。
+本项执行时校验必已通过：
 
-**验证 DoD**：重试后校验通过 → 标记 Done，进入 Item 6；重试 3 次耗尽 → stderr 输出错误并结束（**不进入 Item 6**）。
-
-### Item 6：输出
-
-将第 6 项标记 in_progress。进入本项时校验必已通过（重试耗尽场景已在 Item 5 结束）：
-
-- 提供 `output` 参数：用 `write` 工具将最终 JSON 数组写入 `output` 指定文件（**禁止创建其他文件**），stdout 输出该文件路径。
-- 未提供 `output` 参数：将最终 JSON 数组直接输出到 stdout，**不写任何文件**。
-
-**验证 DoD**：按输出语义交付（文件路径或 stdout 数组）。通过后标记 Done。
+- 提供 `output` → 用 `write` 将最终 JSON 数组写入该文件（**禁止创建其他文件**），stdout 输出文件路径
+- 未提供 `output` → 将最终 JSON 数组直接输出到 stdout，**不写任何文件**
 
 ## Sprint Review
 
-所有 Backlog Items 完成后：
+本 skill 每次调用 = 无状态独立 Sprint，无跨轮次状态，故不进行 Retrospective。所有 Backlog Items 完成后：
 
 - **对照 Sprint Goal 验证**：产出的是否为 `{{count}}` 条符合 `{{format}}` 格式、`{{language}}` 语言的 JSON 数组且通过 schema 校验？输出语义是否正确（写文件输出路径 / stdout 输出数组）？
 - **展示 Increment**：输出文件路径或 stdout 的 JSON 数组。
-- **简要回顾（Retrospective）**：沉淀 1 条改进项供下一轮采纳。
 
 ## 约束
 
 - 只处理已声明字段（source/format/count/language/output），忽略所有其他传入参数（如 `url`），**禁止**以任何形式使用它们。
-- **禁止使用 WebFetch 或任何网络请求、禁止访问外部网络**；`source` 为空时必须输出 `[]`，绝不自行获取内容。
-- 写文件一律用 `write` 工具；读文件用 `read` 工具；需要中间数据时写入临时文件，以 stdin 重定向传给 node。
-- 禁止使用未授权的 `cp`/`rm`/`mv` 等命令；需要复制、移动或删除临时文件时，一律用允许的 `node -e` 的 fs 模块完成。
-- 内部重试步骤的中间产物用临时文件，完成后清理，禁止写入 output 以外的任何持久文件。
+- **禁止使用 WebFetch 或任何网络请求、禁止访问外部网络**；`source`/`format` 不合法时向 stderr 输出错误信息，绝不自行获取内容。
+- 写文件一律用 `write` 工具；读文件用 `read` 工具；中间数据写入临时文件，以 stdin 重定向传给 node。
+- 禁止使用未授权的 `cp`/`rm`/`mv` 等命令；需要复制、移动或删除临时文件时用 `node -e` 的 fs 模块完成。
+- 中间产物完成后清理，禁止写入 output 以外的任何持久文件。
 
 ## references/ 目录结构
 
@@ -153,14 +110,13 @@ node '<技能目录>/references/validate-schema.js' < <临时 JSON 输入文件>
 
 ```
 references/
-├── input.schema.json5              # 入参字段清单（纯文档）
-├── question.md              # 社交媒体问题 prompt
-├── question.schema.json5    # 输出 JSON Schema
-├── status.md                # 社交媒体动态 prompt
+├── question.md                     # 社交媒体问题 prompt
+├── question.schema.json5           # 输出 JSON Schema
+├── status.md                       # 社交媒体动态 prompt
 ├── status.schema.json5
-├── gallery.md               # 社交媒体图集 prompt
+├── gallery.md                      # 社交媒体图集 prompt
 ├── gallery.schema.json5
-├── article.md               # 社交媒体图文文章 prompt
+├── article.md                      # 社交媒体图文文章 prompt
 ├── article.schema.json5
-└── ...
-```
+└── validate-schema.js              # schema 校验脚本（stdin 输入）
+```

package/skills/revise/references/article.md

@@ -2,20 +2,22 @@
 
 ## Sprint Goal
 
-产出 `{{count}}` 篇适合社交媒体传播的图文文章（抓人标题 + 图文混排正文），整体为 JSON 数组。
+产出 `{{count}}` 篇适合社交媒体传播的图文文章，整体为 JSON 数组。
 
-## 创作原则
+## Style（默认创作风格，可由 `style` 参数覆盖）
 
-基于原始素材创作，聚焦 format 特有要点：
+基于原始素材创作：
 
-1. **标题要抓人**：有吸引力、有冲突点，读者靠标题决定是否点开
-2. **正文适合快速阅读**：图文混排，段落短、节奏快，文本块与图片块交替出现，建议文本为主、图片辅助，整体 1-20 行
-3. **图片按需提取**：从素材中提取图片地址作为 `{"type": "image"}` 块，最多 5 个图片块；素材无图片时全部用 `{"type": "text"}` 块
-4. **基于素材**：从素材中提炼核心信息，重组为流畅文章，不能凭空编造
+1. **标题抓人**：有吸引力、有冲突点，读者靠标题决定是否点开
+2. **节奏快**：段落短、节奏快，适合快速阅读
 
-## 输出契约
+## Format（输出契约，不可被 `style` 覆盖）
 
-每个 item 结构严格符合 schema `references/article.schema.json5`：`title`（10-30 cn_length）、`blocks`（array，1-20 个，每个含 `type`（text/image）+ `content`）。**整体输出为 JSON 数组，含 `{{count}}` 个 item。**
+- **结构**：每 item = `title`（10-30 cn_length）+ `blocks`（array，1-20 个，每个含 `type`（text/image）+ `content`）
+- **图文混排**：文本块与图片块交替出现，建议文本为主、图片辅助
+- **图片**：从素材中提取图片地址作为 `{"type": "image"}` 块，最多 5 个图片块；素材无图片时全部用 `{"type": "text"}` 块
+- **真实性**：从素材中提炼核心信息，重组为流畅文章，不能凭空编造
+- **输出形式**：整体为 JSON 数组，含 `{{count}}` 个 item；仅输出数组，不包含任何解释、思考过程或额外文本，禁止输出单个对象
 
 > 字数计算采用 **cn_length** 规则：中文字符算 1，非中文字符（英文/数字/符号）算 0.5，结果向上取整。
 
@@ -32,9 +34,4 @@
     ]
   }
 ]
-```
-
-## 铁律
-
-- 仅输出 JSON 数组，不要包含任何解释、思考过程或额外文本
-- 输出始终为数组，包含 `{{count}}` 个 item（默认 1），禁止输出单个对象
+```

package/skills/revise/references/gallery.md

@@ -2,20 +2,21 @@
 
 ## Sprint Goal
 
-产出 `{{count}}` 个适合社交媒体传播的图集内容（吸睛标题 + 图片列表），整体为 JSON 数组。
+产出 `{{count}}` 个适合社交媒体传播的图集内容，整体为 JSON 数组。
 
-## 创作原则
+## Style（默认创作风格，可由 `style` 参数覆盖）
 
-基于原始素材创作，聚焦 format 特有要点：
+基于原始素材创作：
 
-1. **标题要吸引**：点明图集主题，有看点、让人想点开
-2. **每张图配说明**：`images[].title` 简要说明图片内容，有助于读者理解
-3. **图片从素材提取**：从原始素材中提取图片地址，素材中图片不足时可适当精选
-4. **基于素材**：从素材中提炼主题，不能凭空编造
+1. **标题吸引**：点明图集主题，有看点、让人想点开
 
-## 输出契约
+## Format（输出契约，不可被 `style` 覆盖）
 
-每个 item 结构严格符合 schema `references/gallery.schema.json5`：`title`（10-30 cn_length）、`images`（array，1-50 个，每个含 `url` + `title`（10-30 cn_length））。**整体输出为 JSON 数组，含 `{{count}}` 个 item。**
+- **结构**：每 item = `title`（10-30 cn_length）+ `images`（array，1-50 个，每个含 `url` + `title`（10-30 cn_length））
+- **配说明**：每张图必须带 `title` 简要说明图片内容——schema 必填，不可省略
+- **图片来源**：从原始素材中提取图片地址，素材中图片不足时可适当精选
+- **真实性**：从素材中提炼主题，不能凭空编造
+- **输出形式**：整体为 JSON 数组，含 `{{count}}` 个 item；仅输出数组，不包含任何解释、思考过程或额外文本，禁止输出单个对象
 
 > 字数计算采用 **cn_length** 规则：中文字符算 1，非中文字符（英文/数字/符号）算 0.5，结果向上取整。
 
@@ -31,9 +32,4 @@
     ]
   }
 ]
-```
-
-## 铁律
-
-- 仅输出 JSON 数组，不要包含任何解释、思考过程或额外文本
-- 输出始终为数组，包含 `{{count}}` 个 item（默认 1），禁止输出单个对象
+```

package/skills/revise/references/question.md

@@ -2,20 +2,21 @@
 
 ## Sprint Goal
 
-产出 `{{count}}` 条适合社交媒体传播的问题内容（尖锐标题 + 简洁描述），整体为 JSON 数组。
+产出 `{{count}}` 条适合社交媒体传播的问题内容，整体为 JSON 数组。
 
-## 创作原则
+## Style（默认创作风格，可由 `style` 参数覆盖）
 
-基于原始素材创作，聚焦 format 特有要点：
+基于原始素材创作：
 
-1. **标题要尖锐**：有争议性、冲突点，能激发讨论欲和互动
-2. **描述要简洁**：说明背景，引出矛盾点，不要太长
-3. **图片按需提取**：从素材中提取图片地址，最多 5 张；素材无图片时为空数组
-4. **基于素材**：从素材中提取核心矛盾点，不能凭空编造
+1. **标题尖锐**：有争议性、冲突点，能激发讨论欲和互动
+2. **描述简洁**：说明背景，引出矛盾点，不要太长
 
-## 输出契约
+## Format（输出契约，不可被 `style` 覆盖）
 
-每个 item 结构严格符合 schema `references/question.schema.json5`：`title`（10-30 cn_length）、`content`（20-500 cn_length）、`images`（string[]，≤5）。**整体输出为 JSON 数组，含 `{{count}}` 个 item。**
+- **结构**：每 item = `title`（10-30 cn_length）+ `content`（20-500 cn_length）+ `images`（string[]，≤5 张）
+- **图片**：从素材提取图片地址，最多 5 张；素材无图片时为空数组
+- **真实性**：从素材中提取核心矛盾点，不能凭空编造
+- **输出形式**：整体为 JSON 数组，含 `{{count}}` 个 item；仅输出数组，不包含任何解释、思考过程或额外文本，禁止输出单个对象
 
 > 字数计算采用 **cn_length** 规则：中文字符算 1，非中文字符（英文/数字/符号）算 0.5，结果向上取整。
 
@@ -29,9 +30,4 @@
     "images": ["https://example.com/pic1.jpg"]
   }
 ]
-```
-
-## 铁律
-
-- 仅输出 JSON 数组，不要包含任何解释、思考过程或额外文本
-- 输出始终为数组，包含 `{{count}}` 个 item（默认 1），禁止输出单个对象
+```

package/skills/revise/references/status.md

@@ -2,20 +2,21 @@
 
 ## Sprint Goal
 
-产出 `{{count}}` 条适合社交媒体传播的动态内容（短平快正文），整体为 JSON 数组。
+产出 `{{count}}` 条适合社交媒体传播的动态内容，整体为 JSON 数组。
 
-## 创作原则
+## Style（默认创作风格，可由 `style` 参数覆盖）
 
-基于原始素材创作，聚焦 format 特有要点：
+基于原始素材创作：
 
-1. **正文要精炼**：短平快，提炼核心信息，避免大段照抄原文
+1. **正文精炼**：短平快，提炼核心信息，避免大段照抄原文
 2. **有观点、易互动**：口语化表达，带个人观点或情绪，能引发讨论和转发
-3. **图片按需提取**：从素材中提取图片地址，最多 5 张；素材无图片时为空数组
-4. **基于素材**：从素材中提炼要点，不能凭空编造
 
-## 输出契约
+## Format（输出契约，不可被 `style` 覆盖）
 
-每个 item 结构严格符合 schema `references/status.schema.json5`：`content`（20-500 cn_length）、`images`（string[]，≤5）。**整体输出为 JSON 数组，含 `{{count}}` 个 item。**
+- **结构**：每 item = `content`（20-500 cn_length）+ `images`（string[]，≤5 张）
+- **图片**：从素材中提取图片地址，最多 5 张；素材无图片时为空数组
+- **真实性**：从素材中提炼要点，不能凭空编造
+- **输出形式**：整体为 JSON 数组，含 `{{count}}` 个 item；仅输出数组，不包含任何解释、思考过程或额外文本，禁止输出单个对象
 
 > 字数计算采用 **cn_length** 规则：中文字符算 1，非中文字符（英文/数字/符号）算 0.5，结果向上取整。
 
@@ -28,9 +29,4 @@
     "images": ["https://example.com/pic1.jpg"]
   }
 ]
-```
-
-## 铁律
-
-- 仅输出 JSON 数组，不要包含任何解释、思考过程或额外文本
-- 输出始终为数组，包含 `{{count}}` 个 item（默认 1），禁止输出单个对象
+```

package/src/config.js

@@ -0,0 +1,29 @@
+// src/config.js — harness 配置加载（只读参考 + 初始化检测）
+import path from 'node:path'
+import { fileURLToPath } from 'node:url'
+import { createConfigLoader, getXdgConfigDir } from '@wwkit/shared'
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url))
+
+const _loader = createConfigLoader({
+  builtinConfigPath: path.join(__dirname, 'config.json5'),
+  userConfigDir: getXdgConfigDir('harness'),
+  envContentVar: 'HARNESS_CONFIG_CONTENT',
+  envDirVar: 'HARNESS_CONFIG_DIR',
+})
+
+/**
+ * 获取用户配置文件路径
+ * @returns {string}
+ */
+export function getConfigPath() {
+  return _loader.userConfigPath
+}
+
+/**
+ * 合并内置配置到用户配置文件（追加缺失 key，不覆盖已有值）
+ * @returns {boolean} 是否写入了文件
+ */
+export function mergeBuiltinConfig() {
+  return _loader.mergeBuiltinConfig()
+}

package/src/config.json5

@@ -0,0 +1,19 @@
+// config.json5 — harness 内置配置（只读参考）
+//
+// 此文件为只读配置，由 postinstall 或首次运行时复制到
+// ~/.config/harness/config.json5（或 $XDG_CONFIG_HOME/harness/config.json5）。
+// 实际运行配置通过环境变量生效，此文件主要用于：
+//   1. 配置初始化检测（existsSync 判断是否需要复制）
+//   2. 文档参考（记录 harness 依赖的环境变量）
+//
+// 修改此文件不会影响运行时行为，请通过 shell profile 直接管理环境变量。
+
+{
+  // 环境变量声明（只读 — 由 postinstall 通过 Shell.setEnvVar 自动设置）
+  env: {
+    // harness 包安装目录（agents/skills/commands 所在路径）
+    OPENCODE_CONFIG_DIR: "",
+    // 启用 opencode 实验性 LSP 工具
+    OPENCODE_EXPERIMENTAL_LSP_TOOL: "true",
+  },
+}

package/skills/extract/references/format-aliases.json5

@@ -1,22 +0,0 @@
-{
-  // format 别名映射表：供 agent 将用户的自然语言描述翻译为 format 标准值。
-  // 用户可能用中文/口语而非英文标识，按以下 terms 命中匹配。
-  "aliases": {
-    "list": {
-      "description": "列表提取：从列表页提取多条目（HTML 或结构化 JSON 两种来源）",
-      "terms": ["列表", "多条", "集合", "条目", "list"]
-    },
-    "detail": {
-      "description": "详情提取：单条详情/正文内容",
-      "terms": ["详情", "正文", "单条", "内容页", "detail"]
-    },
-    "text": {
-      "description": "纯文本提取：HTML 转纯文本",
-      "terms": ["纯文本", "文字", "文本", "转文本", "text"]
-    },
-    "navi": {
-      "description": "导航提取：生成栏目/链接导航的 XPath",
-      "terms": ["导航", "栏目", "链接导航", "navi"]
-    }
-  }
-}

package/skills/extract/references/input.schema.json5

@@ -1,23 +0,0 @@
-{
-  // extract 技能入参字段清单（纯文档用途，供 agent 解析入参时参照，不做运行时校验）。
-  "title": "extract 技能入参字段清单",
-  "type": "object",
-  "properties": {
-    "source": {
-      "type": "string",
-      "description": "网页 HTML/文本内容，或本地文件路径",
-      "required": true
-    },
-    "format": {
-      "type": "string",
-      "description": "提取类型。标准值为 list/detail/text/navi 之一",
-      "enum": ["list", "detail", "text", "navi"],
-      "required": true
-    },
-    "url": {
-      "type": "string",
-      "description": "页面 URL；source 为相对路径时基于它转为绝对路径",
-      "required": false
-    }
-  }
-}

package/skills/query/references/input.schema.json5

@@ -1,25 +0,0 @@
-{
-  // query 技能入参字段清单（纯文档用途，供 agent 解析入参时参照，不做运行时校验）。
-  "title": "query 技能入参字段清单",
-  "type": "object",
-  "properties": {
-    "prompt": {
-      "type": "string",
-      "description": "任务要求，包含输出格式说明",
-      "required": true
-    },
-    "source": {
-      "type": "string",
-      "description": "原始素材：普通文本或本地文件路径"
-    },
-    "language": {
-      "type": "string",
-      "description": "输出内容语言，默认 中文",
-      "default": "中文"
-    },
-    "output": {
-      "type": "string",
-      "description": "输出文件路径，未提供时输出到 stdout"
-    }
-  }
-}

package/skills/revise/references/format-aliases.json5

@@ -1,22 +0,0 @@
-{
-  // format 别名映射表：供 agent 将用户的自然语言描述翻译为 format 标准值。
-  // 用户可能用中文/口语而非英文标识，按以下 terms 命中匹配。
-  "aliases": {
-    "question": {
-      "description": "社交媒体风格问题：尖锐标题 + 简洁描述，激发讨论/互动",
-      "terms": ["问题", "提问", "互动话题", "话题", "question"]
-    },
-    "status": {
-      "description": "简短社交动态：微博/朋友圈式的一句话或短文字",
-      "terms": ["动态", "微博", "朋友圈", "状态", "一句话", "status"]
-    },
-    "gallery": {
-      "description": "多图图集：以图片为主的多图形式",
-      "terms": ["图集", "相册", "多图", "图片合集", "gallery"]
-    },
-    "article": {
-      "description": "图文文章：较长的图文长文",
-      "terms": ["文章", "图文", "长文", "推文", "article"]
-    }
-  }
-}

package/skills/revise/references/input.schema.json5

@@ -1,28 +0,0 @@
-{
-  // revise 技能入参字段清单（纯文档用途，供 agent 解析入参时参照，不做运行时校验）。
-  "title": "revise 技能入参字段清单",
-  "type": "object",
-  "properties": {
-    "source": {
-      "type": "string",
-      "description": "原始素材：普通文本或 JSON 字符串，或本地文件路径",
-      "required": true
-    },
-    "format": {
-      "type": "string",
-      "description": "创作格式。标准值为 question/status/gallery/article 之一",
-      "enum": ["question", "status", "gallery", "article"],
-      "required": true
-    },
-    "count": {
-      "type": "integer",
-      "description": "生成的 item 数量，默认 1",
-      "default": 1
-    },
-    "language": {
-      "type": "string",
-      "description": "输出内容语言，默认 中文",
-      "default": "中文"
-    }
-  }
-}