article-writer

name	article-writer
description	技术自媒体文章写作工作流。支持自定义选题；无明确素材时优先委派 subagent 调用 news-skill 获取热点并筛选选题，否则 inline 执行同等流程。经提纲审批后按写作指南完成写作，输出含配图占位符的 Markdown 文章，支持审查修改与写作经验复盘。使用场景：用户需要写技术博客、自媒体文章、AI/编程/产品类科普文；支持平台参数（xiaohongshu、wechat）加载对应平台写作规范。触发词：写文章、写一篇、帮我写、创作文章、生成文章。

Article Writer

技术自媒体文章写作工作流。输出物：output/{slug}/article.md，其中包含配图占位符，供 article-illustrator skill 使用。

强制门禁

以下规则具有最高优先级，任何时候都不得跳过：

1. 每次只能推进一个阶段，不得在未完成当前阶段审批前自动进入下一阶段。
2. 没有用户明确确认，就不得把候选选题、提纲、初稿视为已批准。
3. 每个阶段只输出该阶段产物，不要顺手生成下一阶段内容。
4. 如果缺少用户确认，必须停止并明确提示下一步需要什么确认。

工作目录约定

所有文章输出到 output/{slug}/ 目录（slug 由文章标题自动生成，如 bmad-framework-analysis）：

output/{slug}/
├── article.md          ← 本 skill 输出
└── images/             ← 由 article-illustrator 填充

配图占位符格式

写作时在合适的位置插入：

<!-- img: cover | 封面图描述，体现文章主题 -->

<!-- img: img-01 | 配图描述，说明此处配图的内容和作用 -->

• cover：封面图，放在文章头部（frontmatter 之后，正文第一句之前）
• img-01、img-02...：正文配图，按出现顺序编号，放在需要视觉辅助的段落之前

工作流

Step 1：确定选题

分支 A — 用户已提供选题：直接进入 Step 2。

分支 B — 用户无明确选题：

执行策略：Subagent 优先

若宿主环境支持调用 subagent（如 Cursor 的 Task 工具），优先派生子 agent 完成素材获取与选题筛选；主 agent 只负责汇总结果、呈现候选并等待用户确认。

Subagent 任务范围（一次性委派，不得拆成多轮反复打扰用户）：

1. 读取选题指南：guidance/topic-selection/general.md；若用户指定平台，额外读取 guidance/topic-selection/platform/{platform}.md
2. 按 news-skill/SKILL.md 执行完整流程（抓取 → 分析筛选 → 生成日报 → 去重落盘）
3. 结合选题指南，从日报或 news-skill/data/ 落盘数据中筛选 3-5 个候选选题
4. 返回结构化结果：每个候选含「标题 + 一句话写作角度 + 素材来源（URL 或日报条目）」

Subagent 返回后，主 agent 必须：

• 将候选列表呈现给用户，不做额外改写或擅自选定
• 若用户要求「更多选题」，可再次委派 subagent（读取已落盘日报二次筛选），或在不支持 subagent 时由主 agent 直接读取落盘数据

Fallback — 不支持 subagent 时：由主 agent 按下列步骤 inline 执行（与原流程等价）：

1. 加载选题指南（如有）：读取 guidance/topic-selection/general.md（通用选题指南）；若用户指定平台（--platform xiaohongshu / --platform wechat 等），额外读取 guidance/topic-selection/platform/{platform}.md。作为选题偏好、风格、受众定位的核心依据。
2. 获取热点并落盘：调用 news-skill 获取近期热点。要求执行完整流程，包含日报 Markdown 文件的生成与去重记录（以确保数据持久化，防止多轮对话后丢失原始信息）。
3. 筛选并推荐：结合「选题指南」，从 news-skill 生成的日报或原始数据中筛选 3-5 个适合写作的候选选题（列出选题标题 + 一句话说明写作角度）。

交互确认（两种策略共用）：让用户选择。若用户不满意或要求「更多选题」，可重新读取落盘的日报数据进行二次推荐。

硬性要求：在用户明确选定最终选题之前，不得进入提纲阶段，更不得开始写作。

Step 2：列提纲并审批

1. 判断文章类型：概念讲解 / 工程案例 / 个人经历分享（影响导入方式和结构逻辑，详见写作指南）
2. 输出提纲：含完整章节结构 + 各节要点 + 预计总字数
3. 等待用户审批，按反馈迭代修改，直至用户确认

硬性要求：提纲输出完成后必须停住，不能自动开始正文写作。只有当用户明确表示“确认提纲”或同义明确确认后，才允许进入 Step 3。

Step 3：写作

加载顺序（每次写作前执行）：

1. 读取 guidance/writing/general.md（通用写作指南）
2. 若用户指定平台（--platform xiaohongshu / --platform wechat）：额外读取 guidance/writing/platform/{platform}.md
3. 若文章属于特定场景/题材（如访谈稿、某类分享 SOP），且 guidance/writing/ 下存在对应的场景指南文件：额外读取该文件
4. 若用户在本次调用中提出了具体写作要求：优先级最高，覆盖指南中的冲突规则

写作要点：

• 按提纲展开，遵循写作指南的行文规范
• 在合适位置插入配图占位符（每篇至少 1 个封面 + 1-3 个正文配图，视文章长度和内容类型决定）
• 输出完整文章到 output/{slug}/article.md

硬性要求：正文初稿完成后，必须停止并请求用户审稿。不得在未收到用户反馈前，擅自修改成终稿或进入发布流程。

Slug 生成规则：取文章标题的关键词，转为小写英文加连字符，例如 BMAD 框架深度解析 → bmad-framework-analysis

Step 4：审查与修改

1. 呈现文章给用户（或告知文件路径）
2. 按用户反馈修改，可多轮迭代
3. 用户明确表示满意后进入 Step 5

硬性要求：没有用户明确满意，不得进入 Step 5 的复盘与指南更新。

Step 5：复盘与更新写作指南

1. 复盘本次修改过程，提炼 1-3 条有实际价值的写作经验或注意点
2. 向用户展示提炼结果，询问是否更新到对应指南：
   • 通用选题经验 → guidance/topic-selection/general.md
   • 平台专属选题经验 → guidance/topic-selection/platform/{platform}.md（不存在则创建）
   • 通用写作经验 → guidance/writing/general.md
   • 平台专属写作经验 → guidance/writing/platform/{platform}.md（不存在则创建）
   • 特定场景/题材的详细指南 → 在 guidance/writing/ 下新建独立文件；可选在 general.md 中添加引用
3. 用户同意后更新对应文件；用户拒绝则跳过

References

• 通用选题指南：guidance/topic-selection/general.md — 在 Step 1 加载
• 平台选题指南：guidance/topic-selection/platform/{platform}.md — 在用户指定平台时额外加载
• 通用写作指南：guidance/writing/general.md — 在 Step 3 写作前加载，适用于所有文章
• 平台写作指南：guidance/writing/platform/xiaohongshu.md、guidance/writing/platform/wechat.md — 在用户指定平台时额外加载
• 场景写作指南：guidance/writing/ 下的独立文件（如 优质分享题材-sop.md）— 在匹配场景时额外加载