| name | technical-writing |
| description | Use when the user wants to write, revise, rewrite, continue, polish, or structure a technical article, tutorial, guide, blog post, long-form documentation, or existing technical draft. |
技术文章写作助手
概述
工作流 skill，辅助用户从零到一产出技术文章。所有阶段产物落盘为文件，支持增量写作和跨会话恢复。
核心原则： 不教写作理论，通过结构化流程 + 文件落盘把文章写出来。
适用场景
- 用户说"帮我写一篇技术文章/教程/指南"
- 用户说"帮我改写/润色/重写这篇技术文章"
- 用户说"继续写这篇教程/文档/草稿"
- 用户有一个技术主题但不知道怎么组织
- 用户有草稿但需要改进
不适用： 代码注释、commit message、PR 描述等短文本。
文件约定
所有阶段产物写入用户指定的项目目录。首次使用时向用户确认目录路径。
{project}/
├── outline.md # 阶段 1-2：元信息、大纲、进度追踪
├── article.md # 阶段 3-6：正文
├── peer-review.md # 阶段 5：多视角他审报告 + 主 Agent 回应
└── [其他素材文件] # 用户已有素材，只读不改
文件格式模板见 file-formats.md。
快速入口
- 读取项目目录中的
outline.md、article.md、peer-review.md（若存在），判断恢复点
- 无文件 → 从阶段 1 开始
- 有文件 → 按「恢复协议」确定起点，继续未完成阶段
恢复协议
每次启动时先检测文件状态，读文件恢复进度，不依赖对话历史。
| 检测结果 | 恢复动作 |
|---|
无 outline.md | 从阶段 1（信息收集）开始 |
outline.md 元信息不完整 | 补充缺失信息 |
outline.md 完整但未经用户确认 | 展示大纲并请求确认 |
outline.md 已确认 + article.md 部分章节 | 从下一章继续扩写 |
outline.md 已确认 + article.md 全部章节，无 peer-review.md | 进入阶段 4 或阶段 5 |
peer-review.md 存在但「主 Agent 回应」未完成 | 继续阶段 5 回应流程 |
peer-review.md 已完成，待用户确认 | 展示回应表，请用户确认采纳项 |
peer-review.md 用户已确认 | 进入阶段 6（反馈迭代） |
工作流程
- 检测文件 → 按恢复协议判断起点
- 阶段 1：信息收集 → 明确主题、受众、目标、类型、平台
- 阶段 2：生成大纲 → 写入
outline.md，等用户确认
- 阶段 3：逐章扩写 → 每章追加到
article.md，更新进度表
- 阶段 4：自审优化 → 直接编辑
article.md
- 阶段 5：他审 → 并行 subagent 多视角审阅，主 Agent 逐条回应，用户确认采纳项
- 阶段 6：反馈迭代 → 大改重写章节 / 微调直接编辑 / 满意则交付
阶段 1：信息收集
在写任何内容之前，向用户确认以下信息。用户未提供的，主动询问：
| 信息 | 问题 |
|---|
| 主题 | 具体写什么？ |
| 受众 | 读者是谁？技术水平？ |
| 目标 | 读者读完后能做什么 / 理解什么？ |
| 类型 | 教程 / 概念讲解 / 对比分析 / 实战指南？ |
| 平台 | 博客 / 公众号 / 官方文档 / 掘金？ |
可选补充：
- 参考文章或竞品内容
- 涉及具体代码或项目
- 字数要求
- 风格偏好
模糊主题必须追问后再继续。 收集完成后确认项目目录路径。
进入条件：
退出条件：
- 主题、受众、目标、类型、平台已明确
- 项目目录路径已确认
禁止事项：
阶段 2：生成大纲 → 写入 outline.md
基于信息收集结果生成大纲并写入 outline.md。
进入本阶段前，读取 file-formats.md 获取 outline.md 模板。
确认规则：
- 写入文件后告知用户文件路径，等待确认或修改
- 用户可直接在 IDE 中编辑
outline.md，也可口述修改
- 只有用户确认后才能进入阶段 3
进入条件：
- 阶段 1 已完成
- 尚无可用大纲，或现有大纲需要重写
退出条件：
outline.md 已写入- 用户已明确确认大纲可继续
禁止事项：
- 用户未确认就进入阶段 3
- 只在对话里展示大纲而不落盘
阶段 3：逐章扩写 → 写入 article.md
不要一次写完全文。 按大纲逐章扩写，每完成一章：
- 将该章内容追加到
article.md
- 更新
outline.md 进度表中该章状态为 初稿完成
如果用户在场，可以每章确认后再写下一章；用户要求连续写时，逐章写完即可。
进入本阶段前，读取 writing-guide.md 获取撰写原则和文章结构参考。
进入条件：
退出条件：
- 所有章节都已写入
article.md
outline.md 中对应章节状态已更新
禁止事项：
- 一次输出全文但不落盘
- 跳过
outline.md 直接自由发挥新增结构
- 在阶段 2 未确认时开始正文写作
阶段 4：自审与优化 → 编辑 article.md
全文初稿完成后，执行自审并直接编辑 article.md，更新 outline.md 进度状态为 已审阅。
进入本阶段时：
- 读取 writing-guide.md 执行自审清单
- 读取 writing-style.md 执行事实核查、信息密度控制、去 AI 味和语言风格修正
进入条件：
- 全文初稿已完成
- 当前目标是修正文内问题，而不是新增结构
退出条件：
禁止事项：
- 在正文未写完时提前进入自审
- 把他审当成自审替代品
- 为了自审方便而重写整篇文章
阶段 5：他审 → 写入 peer-review.md
自审通过后，以 outline.md 中定义的受众为基础，派出多个并行 subagent，以不同读者视角审阅 article.md，汇总反馈后主 Agent 逐条回应，由用户最终确认采纳项。
进入本阶段前，读取 peer-review-process.md 获取：
- 审阅视角推导规则
- subagent 提示词模板
peer-review.md 模板- 主 Agent 回应流程
- 用户确认流程
用户确认采纳项后，按采纳项更新正文，再进入阶段 6。
进入条件：
- 阶段 4 已完成
- 需要模拟目标受众反馈，或用户明确要求他审
退出条件：
peer-review.md 已写入- 主 Agent 已逐条回应
- 用户已确认采纳项
禁止事项：
- 未经主 Agent 汇总就直接根据 subagent 原话改正文
- 让 subagent 直接重写全文
- 用他审跳过阶段 4 自审
阶段 6：用户反馈与迭代
本阶段只处理用户本人新增反馈，不重复处理已在 peer-review.md 中完成决议的问题。
告知用户 article.md 已完成自审 / 他审，收集反馈：
- 大改（结构调整、缺少章节、方向偏差）→ 重写相关章节，重新自审
- 微调（措辞、格式、细节补充）→ 直接编辑
article.md
- 用户满意 → 交付终稿
用户可直接在 IDE 里编辑 article.md，也可在对话中描述修改意见。
文件更新顺序（铁律）
任何结构或论点变更，必须先改 outline.md，再改 article.md。
- 新增、删除、调整章节内容 → 先更新
outline.md 对应要点，再编辑正文
- 新增论点或素材 → 先在
outline.md 中明确归属章节，再写入正文
- 纯措辞微调 → 可以只改
article.md
为什么： outline.md 是文章的单一事实来源。跳过大纲直接改正文，会让两个文件逐渐失去同步，影响后续恢复、扩写和迭代。
避免过度打磨。 用户确认满意即为完成。
进入条件：
- 阶段 5 已完成，或用户明确要求跳过他审
- 当前收到的是用户本人新增意见
退出条件：
- 用户反馈已处理
- 用户明确表示满意，或暂无进一步修改
禁止事项：
- 重复处理
peer-review.md 中已决议的问题
- 把阶段 6 当成第二轮他审
行为准则
| 应该做 | 不应该做 |
|---|
| 每个阶段产物写入文件 | 产物只留在对话里 |
| 逐章扩写，每章落盘 | 一次输出全文 |
内容变更先改 outline.md 再改 article.md | 跳过大纲直接改正文 |
| 新会话读文件恢复进度 | 依赖对话历史 |
| 等用户确认大纲后再写正文 | 跳过确认直接写 |
| 按受众水平调整深度 | 所有读者同一深度 |
| 根据反馈精准编辑文件 | 每次反馈后重写全文 |
| 他审反馈逐条查证，再让用户确认取舍 | 直接替用户决定所有反馈的取舍 |
| 适时结束，交付成品 | 无限循环打磨 |
额外资源
