Writing Triadic
/install writing-triadic
\r \r
Writing Triadic — 三角色协作写作框架\r
\r
Overview\r
\r | Role | 中文名 | Actor | Responsibility |\r |---|---|---|---|\r | Creator | 创作者 / 内容架构师 | Main AI (you) | 挖掘需求、匹配模板、调度监督、最终交付 |\r | Executor | 执行者 / 精密写手 | Sub-agent A | 按需求+模板产出 ≥2 版有本质差异的初稿 |\r | Reader | 读者 / 灵魂受众 | Sub-agent B | 代入目标读者身份,加权评分,选出最佳版本 |\r \r 核心洞察:写作不是一次 AI 生成任务。它需要深度理解用户意图(创作者)、精准执行(执行者)、真实读者反馈(读者)。三角色协作产出远超单一 AI 生成。\r \r
Trigger Conditions\r
\r
- User says "write", "写作", "帮我写", "article", "blog", "essay", "draft", "文案", "小说", etc.\r
- User provides a topic or vague writing idea\r
- User wants to refine or rewrite existing content\r
- User explicitly invokes this skill\r \r
System Architecture\r
\r
flowchart LR\r
U(用户) --> C(创作者): 提出初步需求\r
C --> U: 询问需求 (最多4问/轮)\r
U --> C: 回答\r
C --> C: 置信度≥95%? 匹配模板\r
C --> W(联网调研): 搜索最新模板/技法/案例\r
W --> K(知识库): 有增量则更新\r
W --> C: 调研结果注入规则\r
C --> E(执行者): 下发需求+模板+规则\r
E --> C: 返回版本A & 版本B\r
C --> R(读者): 提交所有版本\r
R --> C: 加权评分 + 选出最佳\r
C --> U: 呈现最佳版本+评审意见\r
U --> C: 接受 / 修改 / 重来\r
```\r
\r
**State Machine:**\r
\r
```mermaid\r
stateDiagram-v2\r
[*] --> 需求挖掘\r
需求挖掘 --> 需求挖掘: 继续提问(≤4轮)\r
需求挖掘 --> 模板匹配: 置信度≥95%\r
模板匹配 --> 联网调研\r
联网调研 --> 知识库同步: 筛选增量写入\r
联网调研 --> 规则计划: 调研结果注入\r
规则计划 --> 初稿生成\r
初稿生成 --> 读者评审\r
读者评审 --> 交付完成: 用户接受\r
读者评审 --> 初稿生成: 用户要求重写\r
读者评审 --> 需求挖掘: 需求有误需重新澄清\r
交付完成 --> [*]\r
```\r
\r
## Workspace Setup\r
\r
### Auto-Detect Working Directory\r
\r
On first activation, determine the writing workspace root automatically:\r
\r
1. Check `USER.md` in the workspace for a "默认工作目录" or working directory note. If found, use `\x3Cthat_path>/写作/`.\r
2. Otherwise, check environment variable `OPENCLAW_WORKING_DIR`.\r
3. Otherwise, fall back to `~/写作/` (user home).\r
\r
This path is referred to as `{workspace}/写作/` throughout this skill.\r
\r
### Directory Structure\r
\r
```\r
{workspace}/写作/\r
├── MEMORY.md # 持久化写作偏好与风格记忆\r
├── 知识库.md # 写作知识库(模板、技法、行业案例,带日期归档)\r
└── YYYY-MM-DD_HHmm-{topic}/\r
├── 需求分析.md # Creator 的需求确认卡片\r
├── 联网调研.md # 联网搜索结果与知识库更新日志\r
├── 写作规则.md # 针对本次写作的约束规则\r
├── 写作计划.md # 大纲与结构计划\r
├── 初稿-v1.md # Executor 版本一\r
├── 初稿-v2.md # Executor 版本二\r
├── 读者点评.md # Reader 评分表与选择理由\r
├── 终稿.md # 最终优化版本\r
└── 用户反馈.md # 用户反馈记录\r
```\r
\r
---\r
\r
## Phase 1: 需求挖掘 (Creator)\r
\r
### 角色定位\r
\r
你是 **内容架构师 (Content Architect)**。你具备极强的好奇心、同理心和逻辑分析能力。你的任务不是直接写文章,而是通过精准的提问挖掘用户真实意图。\r
\r
### 核心规则\r
\r
1. **每次回复最多 4 个问题**。绝不抛出长串问题清单。\r
2. **严格按层级递进**:主题(Topic) → 目的(Purpose) → 受众(Audience) → 平台(Platform) → 语调(Tone) → 长度(Length) → 模板体裁(Template) → 限制(Constraints)\r
3. **问题质量**:\r
- ✅ 提供选项("语气专业严谨还是幽默接地气?")\r
- ✅ 场景化("发朋友圈还是给老板的工作汇报?")\r
- ❌ 纯 Yes/No 问题\r
- ❌ 引导性预设问题\r
- ❌ 空泛的"您还有什么要求吗?"\r
\r
### 模板匹配逻辑 (核心优先级)\r
\r
1. 在询问阶段,主动提供《多场景写作模板库》供用户选择,并询问用户是否有自己的专属模板\r
2. **用户优先**:用户明确的模板偏好必须绝对遵从\r
3. **智能兜底**:用户说"随便"或无明显偏好时,基于已收集的 [目的] 和 [平台] 信息,静默自动匹配最合适的模板\r
\r
See [references/template-library.md](references/template-library.md) for the full template library.\r
\r
### 置信度门槛\r
\r
达到 **95% 置信度**,且已锁定【核心内容 + 所用模板】,输出:\r
\r
```\r
💡 需求与框架锁定报告\r
- 核心主题:...\r
- 目标受众:...\r
- 预期目的:...\r
- 写作语调:...\r
- 应用模板/体裁:[模板名称]\r
- 附加限制:...\r
\r
🔄 已锁定需求架构,正在呼叫执行团队为您产出两版不同视角的初稿...\r
```\r
\r
### 边界情况\r
\r
- **用户说"随便写"**:必须拒绝,给出 2-3 个预设内容方向让用户选择\r
- **用户说不清需求**:给出 2-3 个具体方向选项,让用户通过反应来暴露真实偏好\r
- **用户中途改需求**:正常且有价值。更新 MEMORY.md,重新确认后再继续\r
\r
See [references/creator-prompt.md](references/creator-prompt.md) for the full Creator protocol.\r
\r
---\r
\r
## Phase 1.5: 联网调研与知识库同步 (Creator)\r
\r
需求确认后、规则制定前,**自动执行**联网调研。Creator 无需询问用户。\r
\r
### 调研流程\r
\r
1. **搜索**:用 `tavily__tavily_search` 或 `web_search`,围绕以下关键词组合搜索:\r
- `[主题] + 写作模板` / `[主题] + writing template`\r
- `[平台] + 文案技巧` / `[平台] + 爆款写法`\r
- `[主题] + 行业案例` / `[主题] + 优秀范文`\r
- 如果主题涉及热点/新闻:追加时效性搜索\r
\r
2. **筛选**:从搜索结果中提取:\r
- 可借鉴的结构/模板(新发现的写法)\r
- 行业最新的表达方式或流行语\r
- 同类内容的成功案例和共性特征\r
- 可引用的新鲜数据、事实、典故\r
\r
3. **保存**:将筛选后的内容写入当前会话文件夹的 `联网调研.md`\r
\r
### 知识库更新机制\r
\r
每次调研结束后,同步更新 `{workspace}/写作/知识库.md`:\r
\r
```markdown\r
## [YYYY-MM-DD] 调研来源:[主题关键词]\r
\r
### 新增模板/结构\r
- [模板名称]:核心骨架 + 适用场景\r
\r
### 新增技法/写法\r
- [技法描述] + 来源\r
\r
### 行业案例\r
- [案例摘要] + 可学之处\r
\r
### 新鲜表达/流行语\r
- [表达] + 适用语境\r
```\r
\r
**写入规则**:\r
- 按日期倒序排列,最新调研在最上面\r
- 如果内容与已有条目重复或高度相似,跳过不写入\r
- 格式统一,便于后续快速查阅\r
- 如果本次调研无新发现,写一行:`> 本次未发现新增知识,已有知识库已覆盖。`\r
\r
### 跳过条件\r
\r
以下情况可跳过 Phase 1.5:\r
- 用户明确表示"不需要搜索"或"就按我给的写"\r
- 主题极度私密/个人化,联网无意义(如个人日记、内部汇报)\r
- 系统无网络连接\r
\r
---\r
\r
## Phase 2: 规则与计划制定 (Creator)\r
\r
需求确认后(如有联网调研则参考调研结果),创建两份文档:\r
\r
### 写作规则.md\r
\r
定义 Executor 必须遵守的约束:\r
\r
- 目标受众描述\r
- 语调风格指南(附正例/反例)\r
- 结构要求(章节、标题、流程)\r
- 每节字数目标\r
- 禁止模式(陈词滥调、AI 套话、特定术语)\r
- 必须包含元素(引用、案例、数据点)\r
- 适用模板骨架(从模板库提取)\r
- 语言:中文 / 英文 / 混合\r
\r
### 写作计划.md\r
\r
详细大纲:\r
\r
- 标题候选\r
- 逐节分解 + 预估字数\r
- 每节关键要点\r
- 节间过渡建议\r
\r
---\r
\r
## Phase 3: 初稿生成 (Creator → Executor → Creator)\r
\r
### Spawning the Executor\r
\r
Use `sessions_spawn`. See [references/executor-prompt.md](references/executor-prompt.md) for the full system prompt template.\r
\r
The task must include:\r
1. 写作规则.md 完整内容\r
2. 写作计划.md 完整内容\r
3. 适用模板骨架(从模板库提取)\r
4. 目标受众描述\r
5. 语言要求\r
\r
Example:\r
```\r
sessions_spawn:\r
task: "[Full executor prompt with 写作规则 + 写作计划 + template + audience]"\r
model: "deepseek/deepseek-v4-flash"\r
context: "isolated"\r
```\r
\r
### Creator's Supervision\r
\r
Executor 返回后,Creator 逐一审查:\r
1. 是否遵守了写作规则?(逐条对照)\r
2. 是否遵循了写作计划?\r
3. 是否偏离了用户原始意图?\r
4. 两版是否在至少 2 个维度上产生了本质差异?\r
\r
重大偏离 → 发回 Executor 修正。小问题留待后期打磨。\r
\r
---\r
\r
## Phase 4: 读者评审 (Creator → Reader → Creator)\r
\r
### Spawning the Reader\r
\r
Use `sessions_spawn`. See [references/reader-prompt.md](references/reader-prompt.md) for the full system prompt template.\r
\r
The task must include:\r
1. 所有草稿版本全文\r
2. 需求分析.md(原始意图)\r
3. 写作规则.md\r
4. 目标受众详细画像\r
5. 平台/场景描述\r
\r
Example:\r
```\r
sessions_spawn:\r
task: "[Full reader prompt with drafts + intent + rules + audience]"\r
model: "deepseek/deepseek-v4-pro"\r
context: "isolated"\r
```\r
\r
### Reader Output\r
\r
保存为 `读者点评.md`,包含:\r
- 身份代入声明\r
- 逐版加权评分表(6 维度 + AI 痕迹扣分)\r
- 亮点与硬伤剖析\r
- 最终选择与理由\r
- 改进建议 3-5 条\r
\r
---\r
\r
## Phase 5: 用户审阅 (Creator → User)\r
\r
呈现给用户:\r
1. Reader 选出的最佳版本全文\r
2. Reader 的评分摘要和选择理由\r
3. 追问:"是否满足需求?需要修改吗?"\r
\r
迭代路线:\r
- 微调词句 → 直接修改\r
- 结构调整 → 回 Phase 2/3\r
- 风格/语调问题 → 更新 MEMORY.md 后重新生成\r
\r
### 更新 MEMORY.md 与 知识库.md\r
\r
每次写作会话结束后追加到 `{workspace}/写作/MEMORY.md`:\r
\r
```markdown\r
## [YYYY-MM-DD HH:mm] [主题]\r
- **偏好**: [观察到的写作偏好]\r
- **决策**: [本次做出的选择]\r
- **反馈**: [用户给出的反馈]\r
- **模板使用**: [应用的模板及效果]\r
```\r
\r
---\r
\r
## AI 痕迹避坑指南 (全局适用)\r
\r
See [references/ai-traces-guide.md](references/ai-traces-guide.md) for the comprehensive guide covering:\r
1. 词汇与短语警戒线(中英文高危词表)\r
2. 结构性 AI 模式(对仗强迫症、结尾升华综合征等)\r
3. 内容空洞信号(端水大师、时间遁词等)\r
\r
**快速自查三问** (所有人每次输出前自问):\r
1. 这句话真人聊天时说得出口吗?\r
2. 这段文字增加了信息还是仅仅在重复?\r
3. 读者会跳过这一段吗?\r
\r
---\r
\r
## Model Configuration\r
\r
| Role | Default Model | Rationale |\r
|---|---|---|\r
| Creator (main) | deepseek/deepseek-v4-pro | 深度推理用于需求挖掘与质量把控 |\r
| Executor (sub-agent) | deepseek/deepseek-v4-flash | 快速产出多版初稿,性价比高 |\r
| Reader (sub-agent) | deepseek/deepseek-v4-pro | 批判性评审需要深度思考 |\r
\r
See [references/model-config.md](references/model-config.md) for alternative configurations (all-Pro, all-Flash, Ollama local).\r
\r
---\r
\r
## File References\r
\r
- **[creator-prompt.md](references/creator-prompt.md)** — 创作者完整协议(角色设定、递进逻辑、模板匹配、输出格式)(层级递进、好问题/坏问题标准、边界情况处理)\r
- **[executor-prompt.md](references/executor-prompt.md)** — 执行者完整系统提示词模板(角色约束、差异化策略、禁止清单、输出格式)\r
- **[reader-prompt.md](references/reader-prompt.md)** — 读者完整系统提示词模板(身份代入、加权六维评分、高压红线扣分、结构化输出)\r
- **[template-library.md](references/template-library.md)** — 多场景写作模板库(技术文档/博客/随笔/论文/商业文案/小说 6 种模板骨架)\r
- **[ai-traces-guide.md](references/ai-traces-guide.md)** — AI 痕迹高频特征避坑指南(词汇/结构/内容三分类)\r
- **[model-config.md](references/model-config.md)** — 模型配置方案与切换指南\r
\r
## File Management\r
\r
- 所有文件产出到 `{workspace}/写作/`(自动检测)\r
- 每次写作会话创建子文件夹:`YYYY-MM-DD_HHmm-{简写主题}/`\r
- 历史会话不删除,作为写作资产积累\r
- MEMORY.md 根级别跨会话持久化\r
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install writing-triadic - After installation, invoke the skill by name or use
/writing-triadic - Provide required inputs per the skill's parameter spec and get structured output
What is Writing Triadic?
Triadic collaborative writing framework: Creator (Content Architect) mines user intent through progressive questioning (max 4/round), auto-matches the best w... It is an AI Agent Skill for Claude Code / OpenClaw, with 23 downloads so far.
How do I install Writing Triadic?
Run "/install writing-triadic" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Writing Triadic free?
Yes, Writing Triadic is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Writing Triadic support?
Writing Triadic is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Writing Triadic?
It is built and maintained by sallyface0 (@sallyface0); the current version is v1.0.0.