cc-connect 移动端排查公众号文章 — 写稿计划

For agentic workers: 按任务顺序执行；每步完成后对照 spec 自检。Steps 使用 checkbox (- [ ]) 跟踪。

Goal: 基于已确认的设计 spec，产出 2000～2500 字公众号初稿 draft.md，符合痛点驱动结构，正文抽象、附录具体。

Architecture: 痛点开篇 → 架构图 → 四层职责 → 价值总结 → 参考实现附录；作为前篇《飞书与 Cursor 互通》续篇，不重复安装教程。

Tech Stack: Markdown 初稿；可选走 aws-wechat-article-* 流水线（review → formatting → images → publish）。

Global Constraints

• 篇幅：2000～2500 字（含表格）
• 读者：研发为主，兼顾 TL / 运维
• 正文：抽象能力层；附录：真实工具链参考
• 不写：安装配置、Skills 开发教程、完整对话 walkthrough、合规讨论
• 图表：1 张架构图 + 1 张附录表格；不用 Mermaid
• 语气：口语化、实战感（对齐 .aws-article/config.yaml 的 writing_style: 口语化）
• 标题：cc-connect 进阶：用手机排查线上问题

File Structure

Task 1: 初始化本篇目录与元数据

Files:

• Create: drafts/20260809-cc-connect-mobile-troubleshooting/topic-card.md
• Create: drafts/20260809-cc-connect-mobile-troubleshooting/article.yaml
• Create: drafts/20260809-cc-connect-mobile-troubleshooting/imgs/（目录）
• Copy: assets/image-fcd307c2-83f5-4e40-b020-0b61aae5085d.png → imgs/architecture.png

Interfaces:

• Produces: topic-card.md 含标题、读者、痛点 A/B/D、结构要点；article.yaml 含 title/digest/default_structure

• Step 1: 创建 topic-card.md，写入 spec 中的 7 节结构要点与三条痛点
• Step 2: 创建 article.yaml：

  title: "cc-connect 进阶：用手机排查线上问题"
  author: ""  # 使用 config default_author 或用户指定
  digest: "前篇讲了飞书远程写代码，这篇讲同一套 cc-connect 如何变成移动端线上排查入口。"
  publish_completed: false
  image_source: generated
  default_structure: ["AI Skill 爆款教程结构"]
  

• Step 3: 复制架构图到 imgs/architecture.png

Task 2: 撰写开篇与三个痛点（~750 字）

Files:

• Create: drafts/20260809-cc-connect-mobile-troubleshooting/draft.md（先写第 1～2 节）

Interfaces:

• Consumes: topic-card.md、design spec §2.2 痛点表

• Produces: draft.md 含 §1 续篇引入 + §2 三个痛点

• Step 1: 写 §1 开篇（~150 字）
  • 一句带过前篇 cc-connect + 远程写代码
  • 转折：线上救火 vs 写代码
  • 本文目标：移动端排查方案
• Step 2: 写 §2 痛点 A（~200 字）— 小标题「人不在工位，电脑够不着」
  • 告警在手机上、VPN/跳板/日志平台移动端难操作
  • 段末：意味着排查入口必须移到手机
• Step 3: 写 §2 痛点 B（~200 字）— 小标题「排查链路太长」
  • 日志 → SQL → IDE 三系统切换
  • 段末：意味着需要 Agent 统一编排
• Step 4: 写 §2 痛点 D（~200 字）— 小标题「排查过程难沉淀」
  • IM 聊完就散、复盘靠回忆
  • 段末：意味着对话链路本身应可留存

Task 3: 架构图与四层职责（~1000 字）

Files:

• Modify: drafts/20260809-cc-connect-mobile-troubleshooting/draft.md（追加 §3～4）

Interfaces:

• Consumes: 架构图 imgs/architecture.png、design spec §3

• Produces: draft.md 含架构图引用 + 四层各 ~200 字

• Step 1: 写 §3 整体方案（~200 字 + 图）
  • 核心思路一句
  • 插入 ![架构图：四层排查工具](imgs/architecture.png) 或 placeholder
  • 数据流 2～3 句
• Step 2: 写 §4 移动端层（~200 字）→ 映射痛点 A
• Step 3: 写 §4 连接器层 cc-connect（~200 字）→ 映射痛点 A
• Step 4: 写 §4 智能体层（~250 字，稍展开 Agent CLI / MCP / Skills）→ 映射痛点 B
• Step 5: 写 §4 数据端 + 定时任务（~200 字）→ 映射痛点 B + D

Task 4: 价值总结、附录与结尾（~650 字）

Files:

• Modify: drafts/20260809-cc-connect-mobile-troubleshooting/draft.md（追加 §5～7）

Interfaces:

• Produces: 完整 draft.md

• Step 1: 写 §5 价值总结（~300 字）— 效率 / mobility / 可沉淀 三维度表格或三段
• Step 2: 写 §6 附录参考实现（~300 字）— 表格 + 免责说明
• Step 3: 写 §7 结尾（~50 字）— 收束 + 可选前篇链接占位

Task 5: 自检与 spec 对照

Files:

• Review: drafts/20260809-cc-connect-mobile-troubleshooting/draft.md

• Step 1: 字数检查 — 2000～2500 字范围
• Step 2: 结构检查 — 7 节齐全，痛点 A/B/D 各出现且段末有「意味着」
• Step 3: 边界检查 — 无安装步骤、无 Mermaid、正文无具体工具名（附录除外）
• Step 4: 配图占位 — 按 image_density: 每节一图 补 ![类型：描述](placeholder)（封面 + 各节）
• Step 5: 展示 draft.md 给用户确认

Task 6（可选）: 公众号流水线后续

Files:

• 产出链: draft.md → article.md → article.html → imgs/ → 发布

• Step 1: 走 aws-wechat-article-review 内容审
• Step 2: 走 aws-wechat-article-formatting 排版
• Step 3: 走 aws-wechat-article-images 配图（含架构图）
• Step 4: 用户确认后走 aws-wechat-article-publish 或仅保留本地稿

Self-Review（Plan vs Spec）

无 TBD / 占位任务。Plan 覆盖 spec 全部章节。