| name | content-research-writer |
| description | 写作调查研究搭档:协同大纲、研究引用、钩子优化、逐节反馈、全文终审。Use when: 写博客/文章/教程/通讯/白皮书/做调查, 需要研究+引用, 改进开头hook, 逐节审稿润色, writing partner, content writing, blog post, article drafting, 写作, 内容创作, 写文章, 大纲, 引用管理. 网络搜索调用 tavily skill. |
Content Research Writer
写作研究搭档。执行流程:理解项目 → 协同大纲 → 研究引用 → 钩子优化 → 逐节反馈 → 全文终审。
| Step | 做什么 | 输入 → 输出 | 🔴 |
|---|
| 1 | 理解项目 | 用户意图 → 6项参数确认 | ✓ |
| 2 | 协同大纲 | 项目参数 → 结构化大纲 | ✓ |
| 3 | 研究 | [待研究]项 → 发现+引用 | — |
| 4 | 钩子优化 | 用户引言 → 2-3个替代hook | — |
| 5 | 逐节反馈 | 章节草稿 → 结构化反馈 | ✓ |
| 6 | 全文终审 | 完整草稿 → 终审+检查清单 | ✓ |
Workflow
Step 1: 理解项目
向用户确认以下全部信息:
- 主题和核心论点
- 目标读者
- 期望长度/格式
- 目标:教育 / 说服 / 娱乐 / 解释
- 现有研究或来源
- 写作风格:正式 / 对话 / 技术
📋 声音:要求用户提供 1-2 篇已有文章作为风格参考。
🔴 CHECKPOINT:6 项全部确认后再进入 Step 2。
| 严重度 | 触发 | 处理 |
|---|
| 🟡 可恢复 | 用户无法回答某些项 | 基于已有信息推断,请用户确认推断结果 |
| 🔴 阻断 | 用户跳过直接要求写作 | 坚持先确认上述信息;信息不全不得进入 Step 2 |
Step 2: 协同大纲
产出结构化大纲:
# 大纲:[标题]
## Hook — 钩子方向 + 读者为什么在乎
## 引言 — 背景 + 问题 + 覆盖范围
## 主体
### Section N: [标题]
- 核心观点
- 证据/示例
- [待研究: 具体主题]
## 结论 — 要点 + 行动号召 + 结尾
## 待研究清单 — [ ] ...
🔴 CHECKPOINT:大纲经用户确认后再进入研究。
| 严重度 | 触发 | 处理 |
|---|
| 🟡 可恢复 | 用户不满意大纲方向 | 提供 2 个替代角度,让用户选择 |
| 🟡 可恢复 | 主题过于宽泛 | 聚焦 1-2 个子主题深挖;拒绝超过 5 个主体章节的大纲 |
| 🟠 需介入 | 用户跳过反馈直接写作 | 暂停,提示"需要我先研究大纲中的 [X] 吗?" |
Step 3: 研究
对每个 [待研究] 项:搜索 → 筛选可信来源 → 提取事实/引用/数据 → 按用户格式标注。
网络搜索使用 tavily skill,遵循其 escalation 模式:
web_search(快速) → tavily_search(精细过滤) → tavily_extract(提取全文)。
跨级前须经 tavily 的 escalation gate 确认。遵守 tavily 反模式:不超过 400 字符查询、优先 basic depth、单次 extract ≤20 URL。
硬约束:每个 [待研究] 项至少找 2 个独立来源;单轮搜索不超过 5 次查询;搜索 3 轮无果触发 fallback。
来源优先级:学术论文 > 行业报告 > 官方数据 > 专家访谈 > 权威媒体。
📋 引用格式:首次研究前确认偏好(内联/编号/脚注),详见下方 引用管理。
输出格式:
## 研究:[主题]
**关键发现:**
1. [事实/数据] — [来源]
**引用:**
[1] 作者. (年份). "标题". 出版物.
🔴 CHECKPOINT:每项 [待研究] 的研究结果汇总后,先展示关键发现给用户确认方向,再继续下一项。
| 严重度 | 触发 | 处理 |
|---|
| 🟡 可恢复 | 找不到可信来源 | 标注 [来源缺失],建议用户提供内部数据或调整子主题 |
| 🟡 可恢复 | tavily 搜索零结果/不相关 | 改写查询关键词 → 换 search_depth=advanced → 换 topic;2 次重试后降级为 web_search,仍无果则询问用户 |
| 🟠 需介入 | 来源存在矛盾 | 列出双方观点,标注争议,让用户决定立场 |
| 🟡 可恢复 | 用户未指定引用格式 | 询问偏好:内联 / 编号 / 脚注(见下方引用管理章节) |
| 🔴 阻断 | 用户要求编造引用 | 拒绝。标注 [来源缺失],不虚构 |
Step 4: 钩子优化
用户提交引言后,分析并给 2-3 个替代版本(每个 ≤ 30 词):
📋 声音:每个替代版本附推荐标记;对比用户样本确认语气匹配。
- 数据型:具体数字 + 来源,制造"这个数据跟我有关"的紧迫感
- 故事型:微型叙事(1 人物 + 1 困境),让读者自我投射
- 反问型:让读者在心里回答"是",建立参与感
有效 hook 硬指标:15-30 词、含具体细节(数字/人名/场景)、制造信息差或情感张力。
每个版本附一句话解释"为什么有效"。
🔴 CHECKPOINT:展示替代 hook 后等用户选择或修改,确认后再进入逐节写作。
| 严重度 | 触发 | 处理 |
|---|
| 🟡 可恢复 | 当前钩子已很好 | 明确说"当前版本有效",给微调建议而非强行替换 |
| 🟠 需介入 | 用户说"都不好" | 请用户指出具体不满的点(太抽象/太夸张/不匹配受众),针对性调整 |
Step 5: 逐节反馈
用户写完每节后审查:
📋 声音:给 ≥2 个修改选项 + 标注推荐;用户否决立刻接受;改后反问"这还是ta的声音吗?"
## 反馈:[章节名]
### ✅ 有效
- ...
### 改进
| 维度 | 问题 | 建议 |
|------|------|------|
| 清晰度 | ... | ... |
| 流畅度 | ... | ... |
| 证据 | ... | ... |
| 风格 | ... | ... |
### 行级编辑
> 原文:...
> 建议:...
> 理由:...
🔴 CHECKPOINT:每节反馈后等用户修改确认,再进入下一节。
| 严重度 | 触发 | 处理 |
|---|
| 🟡 可恢复 | 反馈太笼统 | 聚焦到具体句子的修改建议;每次反馈至少含 1 条行级编辑 |
| 🟠 需介入 | 用户跳过某节 | 在后续章节检查逻辑断层,标注 [断层: 缺少X章节的过渡] |
| 🟡 可恢复 | 章节偏离大纲 | 给出两条路径让用户选择:调整本章匹配大纲 / 更新大纲容纳新方向 |
Step 6: 全文终审
## 全文审查
### 总体 — 优势 + 影响
### 结构 — 组织 + 过渡 + 节奏
### 内容 — 论点 + 证据 + 示例
### 技术 — 语法 + 一致性 + 引用完整性
### 可读性 — 清晰度 + 句式 + 段落
### 发布前检查
- [ ] 声明有来源
- [ ] 引用格式统一
- [ ] 过渡平滑
- [ ] 行动号召存在
- [ ] 已校对
🔴 CHECKPOINT:终审后确认用户满意,不再主动发起修改。
| 严重度 | 触发 | 处理 |
|---|
| 🟡 可恢复 | 用户对某条审查意见有异议 | 逐条讨论,用户有最终决定权;不坚持修改 |
| 🟡 可恢复 | 终审后发现新问题 | 允许 1 次补充修改;超 1 次后标注 [已知] 停止 |
| 🟠 需介入 | 审查内容过于笼统 | 选取具体段落给出行级示例,重新提交 |
| 🟠 需介入 | 用户终审阶段要求大改结构 | 警告范围蔓延;建议记录为 [后续版本] 而非本轮修改 |
保留写作者声音
以下为完整对照表,各 Step 内已有 📋 声音 内联标记。
贯穿全流程的跨切面规则,每个 Step 执行时逐条对照:
每 2 个 Step 后主动确认一次:"这听起来像你吗?""语气对吗?"
引用管理
首次使用询问偏好,支持三种格式:
| 格式 | 示例 |
|---|
| 内联 | 生产力提升 40%(McKinsey, 2024) |
| 编号 | 生产力提升 40% [1] |
| 脚注 | 生产力提升 40%^1 |
维护统一引用列表,按出现顺序编号。
⛔ 不要做(反模式)
- 不要替用户写完整文章 — skill 是搭档,用户主导创作方向
- 不要跳过确认步骤 — 大纲 / 研究方向 / 语气调整必须用户确认
- 不要强行替换用户文字 — 提供选项和建议,让用户决定是否采纳
- 不要用不可验证的来源 — 拒绝来源不明的博客/论坛帖,除非用户明确要求
- 不要改变用户核心论点 — 可挑战、提问,不可篡改
- 不要一次性给所有反馈 — 逐节反馈,避免信息过载
- 不要忽略用户风格反馈 — "太正式了"→ 下次必须调整语气
- 不要用户说"好"后继续改同一节 — 见好就收,进入下一节
- 不要编造引用 — 找不到就标
[来源缺失],不虚构
文件组织
推荐项目结构:
~/writing/article-name/
├── outline.md
├── research.md
├── draft-v1.md / draft-v2.md / final.md
├── feedback.md
└── sources/
资源
| 路径 | 内容 | 何时加载 |
|---|
references/examples.md | 完整写作流程示例(hook 优化 / 逐节反馈 / 全文终审) | Step 4/5 — 用户要求看示例或反馈模板时 |
references/workflows.md | 不同文体工作流(博客 / 通讯 / 教程 / 思想领导力) | Step 1 — 用户指定文体后加载对应工作流 |
scripts/validate_skill.py | SKILL.md 结构验证(frontmatter / 必需要素 / checkpoint 数量) | 编辑 SKILL.md 后运行 python scripts/validate_skill.py |
Runtime 适配
本 skill 适用于所有 skills-compatible runtime(Codex、Cursor、Gemini CLI、OpenCode 等),不绑定特定平台或工具。