设置

首次使用时，请阅读 setup.md 了解集成指南。

适用场景

用户需要写作协助：起草、编辑、反馈或风格适配。Agent 会在各会话间持续记忆其行文语气与偏好。

架构设计

写作偏好持久化存储于 ~/writing/ 目录下，采用分层结构。具体配置方式参见 memory-template.md。

~/writing/
├── memory.md      # HOT：语气、风格、当前活跃偏好
├── projects/      # 按项目划分的语气（博客、通讯、书籍等）
└── archive/       # COLD：已衰减的模式

快速查阅表

触发检测条件

当识别到以下模式时，自动激活对应功能：

求助请求 → 启用写作模式：

• “你能帮我写……吗？”
• “我需要起草……”
• “这样听起来如何？”
• “你能帮我编辑一下这段吗？”
• “让这段更清晰些”
• “修正我的文字”

语气信号 → 保存至 memory.md 的 Voice 部分：

• “我喜欢你这样写……”
• “我的风格是……”
• “我总是以……方式写作”
• “我的文字中永远不要使用 X”
• “对我来说太正式／太随意了”

格式偏好 → 保存至 memory.md 的 Formats 部分：

• “在我的博客中，我……”
• “在邮件中，我倾向于……”
• “学术论文需要……”
• “营销文案应当……”

纠错反馈 → 判定是否应存入记忆：

• “不，这不是我的语气”
• “我绝不会那样表达”
• “太啰嗦／太简短／太正式／太随意”
• “把 X 改成 Y——这才是我的写法”

快捷查询指令

核心规则

1. 首先查阅记忆

执行任何写作任务前，必须先读取 ~/writing/memory.md，并严格遵循其中记录的语气、格式与偏好。

2. 从样例中学习语气

当用户提供自身写作样例时：

1. 在回应前仔细通读全文
2. 注意其语调、节奏、词汇选择、句长特征
3. 在输出中主动匹配上述模式
4. 主动确认：“这样听起来像你吗？”

3. 禁止强加风格

4. 清晰优于巧妙

• 每段只表达一个核心观点
• 简单句优于复杂句
• 删减所有无实际意义的冗余词
• 朗读校验，及时发现拗口表达

5. 上下文感知式写作

6. 分轮次编辑

7. 分层存储机制

8. 自动升/降级机制

• 某偏好在 7 天内被调用 3 次 → 升级为 HOT
• 某偏好连续 30 天未被调用 → 降级为 WARM
• 某偏好连续 90 天未被调用 → 归档至 COLD
• 未经用户确认，绝不删除任何记忆项

9. 透明化操作

• 应用偏好时注明来源：“采用轻松语调（源自 memory.md）”
• 用户要求时，解释具体修改原因
• 每次会话结束后，主动总结本次新学到的内容

常见误区

• 强加自身风格 → 始终优先匹配用户语气
• 过度编辑 → 保留用户个性，避免同质化清洗
• 滥用被动语态 → 默认使用主动语态，除非用户明确偏好被动
• 忽视上下文差异 → 邮件、博客、论文的写作规范截然不同
• 遗忘用户偏好 → 每次任务前都必须检查 memory.md
• 预设正式即正确 → 用户自身的风格对其而言就是唯一正确的

安全与隐私

本地留存的数据包括：

• 位于 ~/writing/ 的写作偏好
• 语气模式与风格笔记
• 项目专属偏好

本能力模块明确不执行以下操作：

• 存储用户生成的实际文本内容（仅保存偏好）
• 发起任何网络请求
• 访问 ~/writing/ 目录以外的任意文件
• 将偏好信息对外共享

相关能力模块

若用户确认安装，可通过 clawhub install 命令添加：

• grammar —— 拼写与语法检查
• text —— 文本处理与变换
• content-marketing —— 内容策略与创作支持

反馈

• 若体验良好：运行 clawhub star writing
• 保持更新：运行 clawhub sync