| 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 等），不绑定特定平台或工具。
