imraywang/wewrite

# WeWrite — 公众号内容主入口

## 运行原则

- 默认连续完成内容流程，不在每一步停下来。用户说“交互模式”时，才在选题和框架处确认。
- 每篇文章必须用独立任务目录，不能覆盖另一篇文章。
- “写一篇”默认只交付审过的本地稿；生成图片和发布都不是默认动作。
- 配图、排版和发布是正文完成后的独立动作；不得为了排版或发布自动触发生图。
- “完整制作”是正文、配图和本地预览的组合快捷方式；只有明确说“推到草稿箱/发布”才允许调用发布命令。
- 搜索失败时可以继续写分析和经验判断，但不得把模型记忆包装成已核实的事实。

`{home}` 是 `wewrite home` 返回的状态目录。`{skill_dir}` 是本 skill 目录。确定性操作走 `wewrite` 命令。

## 路由

# wewrite-learn — 自学习（改稿飞轮 / 范文库 / 排版学习）

## 运行约定

- **CLI**：确定性操作走 `wewrite` 命令（需在 PATH；缺失则引导 `uv tool install wewrite`，或在仓库里 `bash install.sh`）。
- **{home}**：用户状态目录 = `$WEWRITE_HOME` 或 `~/.wewrite`（`wewrite home` 可查）。config/style/history/playbook/output/exemplars 全在 {home}，不在仓库；references 文档中的状态路径同此约定。
- **`读取: <路径>`** = 用文件读取工具真实读完该文件再继续，不是注释。
- **references/**：本 skill 自带 `{skill_dir}/references/`；references 文档内的 `{skill_dir}` 即本 skill 目录。

## 子功能分发

| 用户说 | 动作 |
|--------|------|
| 学习我的修改 / 我改了，学习一下 | `读取: {skill_dir}/references/learn-edits.md`，按其流程执行。支持本地 markdown 修改与微信草稿箱同步（`wewrite learn-edits --from-wechat`） |

# wewrite-publish — 排版、预览、草稿箱

## 前置

用户指定文章时使用该文件；否则 `wewrite run show`。如果
`artifacts.illustrated_article` 存在且非空就使用它，否则使用 `artifacts.article`；读取标题、
摘要、封面、预览路径、发布权限和降级标记。已完成文章可以直接排版或发布，不要恢复写作
任务。主题取 style.yaml 的 `theme`，默认 `professional-clean`。

排版和发布不得自动调用 `wewrite-visual`。没有封面时照常生成本地预览；只有用户另行要求
配图时才进入视觉模块。

用户本轮明确要求“推到草稿箱/发布”时，有任务先运行
`wewrite run permission publish allow`；用户撤回时运行 `wewrite run permission publish deny`。

# wewrite-review — 编辑、改稿与成稿

## 前置

用户指定文章时检查该文件；否则运行 `wewrite run show`，优先读取 `artifacts.draft`，并读取
`artifacts.brief`、`artifacts.claims` 和 `artifacts.sources`。旧任务没有初稿产物时才回退
`artifacts.article`。管道内先运行 `wewrite run step review in_progress`。

完整读取：

```text
读取: {skill_dir}/../wewrite-write/references/article-brief.md
读取: {skill_dir}/../wewrite-write/references/editorial-quality.md
读取: {skill_dir}/references/seo-rules.md

# wewrite-rewrite — 一源多平台改写

## 运行约定

- **CLI**：确定性操作走 `wewrite` 命令（需在 PATH；缺失则引导 `uv tool install wewrite`，或在仓库里 `bash install.sh`）。
- **{home}**：用户状态目录 = `$WEWRITE_HOME` 或 `~/.wewrite`（`wewrite home` 可查）。config/style/history/playbook/output/exemplars 全在 {home}，不在仓库；references 文档中的状态路径同此约定。
- **`读取: <路径>`** = 用文件读取工具真实读完该文件再继续，不是注释。
- **references/**：本 skill 自带 `{skill_dir}/references/`；references 文档内的 `{skill_dir}` 即本 skill 目录。
- **任务状态**：用 `wewrite run show` 读取当前任务。

## 前置

1. **源文章**：按优先级解析——用户指定的文件/粘贴内容 > 当前任务的
   `artifacts.article`。都没有 → 问用户"要改写哪篇？给我文件路径

# wewrite-stats — 文章数据复盘

## 运行约定

- **CLI**：确定性操作走 `wewrite` 命令（需在 PATH；缺失则引导 `uv tool install wewrite`，或在仓库里 `bash install.sh`）。
- **{home}**：用户状态目录 = `$WEWRITE_HOME` 或 `~/.wewrite`（`wewrite home` 可查）。config/style/history/playbook/output/exemplars 全在 {home}，不在仓库；references 文档中的状态路径同此约定。
- **`读取: <路径>`** = 用文件读取工具真实读完该文件再继续，不是注释。
- **references/**：本 skill 自带 `{skill_dir}/references/`；references 文档内的 `{skill_dir}` 即本 skill 目录。

## 执行

```
读取: {skill_dir}/references/effect-review.md
```

# wewrite-style — 风格设置 / Onboard

## 运行约定

- **CLI**：确定性操作走 `wewrite` 命令（需在 PATH；缺失则引导 `uv tool install wewrite`，或在仓库里 `bash install.sh`）。
- **{home}**：用户状态目录 = `$WEWRITE_HOME` 或 `~/.wewrite`（`wewrite home` 可查）。config/style/history/playbook/output/exemplars 全在 {home}，不在仓库；references 文档中的状态路径同此约定。
- **`读取: <路径>`** = 用文件读取工具真实读完该文件再继续，不是注释。
- **references/**：本 skill 自带 `{skill_dir}/references/`；references 文档内的 `{skill_dir}` 即本 skill 目录。
- 本模块是**交互式**的（需要问用户问题），不受主管道"全自动"约束。

## 执行

**触发场景**：
1. 主入口 Step 1 发现 `{home}/style.yaml` 不存在（首次使用）

# wewrite-topic — 选题

## 运行约定

- **CLI**：确定性操作走 `wewrite` 命令（需在 PATH；缺失则引导 `uv tool install wewrite`，或在仓库里 `bash install.sh`）。
- **{home}**：用户状态目录 = `$WEWRITE_HOME` 或 `~/.wewrite`（`wewrite home` 可查）。config/style/history/playbook/output/exemplars 全在 {home}，不在仓库；references 文档中的状态路径同此约定。
- **`读取: <路径>`** = 用文件读取工具真实读完该文件再继续，不是注释。
- **references/**：本 skill 自带 `{skill_dir}/references/`；references 文档内的 `{skill_dir}` 即本 skill 目录。
- **任务状态**：通过 `wewrite run show/update/step` 读取和更新；不直接改状态文件。

## 前置

- `{home}/style.yaml` 存在 → 提取 `topics`、`content_style`。不存在 → 问用户"你的
  公众号主要写哪几个方向？"用回答临时代替 topics，并提示可用 **wewrite-style** 完成完整设置。

# wewrite-visual — 封面与配图

## 前置

用户指定文章时使用该文件；否则 `wewrite run show`，读取当前任务的 `artifacts.article`、
`artifacts.illustrated_article`、`artifacts.image_prompts`、`artifacts.images_manifest`、
`visual`、`flags` 和任务目录。已完成的文章也可以直接配图，不要恢复或新建写作任务。

有任务时运行 `wewrite run step visual in_progress`。用户直接给了任务外文章时独立执行，
不写任务状态；提示词和图片放进文章同目录的 `<文件名>-assets/`，带图副本写成
`<文件名>-illustrated.md`。

根据本轮原话确定模式并用 `wewrite run update` 记录：只要封面用 `cover`，封面和必要内文图
用 `full`，只要提示词用 `prompts`。不要沿用写作模式猜测用户想生图。`prompts` 或

# wewrite-write — 任务书、证据与初稿

## 前置

运行 `wewrite run show` 读取当前任务。没有任务但用户给了选题时，以 `draft` 模式创建；没有
选题则转 `wewrite-topic`。本模块只写 `artifacts.brief`、`artifacts.claims` 和
`artifacts.draft`；`artifacts.article` 由审稿模块在通过后生成。

读取 `{home}/style.yaml`；不存在则先执行 `wewrite-style`。按优先级读取自定义人格
`{home}/personas/<name>.yaml`、内置 `personas/<name>.yaml`，最后回退 `midnight-friend`。
人格只控制表达偏好，不能覆盖事实、个人材料和文章任务书。

进入时运行 `wewrite run step write in_progress`。