wewrite-learn

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

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

wewrite-learn — Self-Learning (Edit Flywheel / Sample Library / Typography Learning)

运行约定

Operating Conventions

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 目录。

CLI: Deterministic operations use the
```
wewrite
```
command (must be in PATH; if missing, guide users to run
```
uv tool install wewrite
```
, or run
```
bash install.sh
```
in the repository).
{home}: User state directory =
```
$WEWRITE_HOME
```
or
```
~/.wewrite
```
(check with
```
wewrite home
```
). All config/style/history/playbook/output/exemplars are stored in {home}, not in the repository; state paths in references documents follow the same convention.
Read: <path>
= Actually read the entire file using a file reading tool before proceeding; this is not a comment.
references/: This skill comes with
```
{skill_dir}/references/
```
;
```
{skill_dir}
```
in references documents refers to the directory of this skill.

子功能分发

Sub-function Dispatching

用户说	动作
学习我的修改 / 我改了，学习一下	`读取: {skill_dir}/references/learn-edits.md` ，按其流程执行。支持本地 markdown 修改与微信草稿箱同步（ `wewrite learn-edits --from-wechat` ）
学习排版 / 学排版 + URL	`wewrite learn-theme <url> --name <name>` ，提取后提示用户设置 style.yaml 的 theme 字段
学习这篇文章 / 导入范文 + URL	`wewrite fetch-article <url> -o /tmp/article.md && wewrite exemplar /tmp/article.md -s <账号名>` ；默认第三方
导入范文 + 本地文件	`wewrite exemplar <文件路径>` ；用户明确为本人文章时加 `--user-authored`
查看范文库	`wewrite exemplar --list`

范文库的用途：exemplars 会在写作模块（wewrite-write）按框架类型注入初稿 prompt，只用于校准结构和节奏，不能复用其中的观点、句子或个人经历。导入完成后告知用户库里现有多少篇、覆盖哪些 category 和所有权标记。

改稿飞轮的价值：每次学习让下一篇初稿更接近用户风格。learn-edits.md 的只有重复出现或用户明确确认的同范围规则才会成为硬约束；单次修改始终只是软参考。

User Input	Action
Learn my edits / I made changes, learn from them	`Read: {skill_dir}/references/learn-edits.md` , execute according to its process. Supports local markdown edits and WeChat draft box sync ( `wewrite learn-edits --from-wechat` )
Learn typography / Learn layout + URL	`wewrite learn-theme <url> --name <name>` , after extraction, prompt the user to set the theme field in style.yaml
Learn from this article / Import sample essay + URL	`wewrite fetch-article <url> -o /tmp/article.md && wewrite exemplar /tmp/article.md -s <account name>` ; default to third-party source
Import sample essay + local file	`wewrite exemplar <file path>` ; add `--user-authored` when the user explicitly states the article is self-authored
View sample library	`wewrite exemplar --list`

Purpose of the Sample Library: Exemplars are injected into the first draft prompt by the writing module (wewrite-write) according to the framework type, and are only used to calibrate structure and rhythm. Viewpoints, sentences, or personal experiences from the samples must not be reused. After import is complete, inform the user how many articles are currently in the library, which categories they cover, and their ownership tags.

Value of the Edit Flywheel: Each learning iteration makes the next first draft closer to the user's style. For rules in learn-edits.md, only rules of the same scope that appear repeatedly or are explicitly confirmed by the user will become hard constraints; a single edit is always just a soft reference.