# 微信公众号写作助手 — 编排方案

## Context

当前项目是一个基于 Claude Code 的个人写作空间，用户希望将散落的写作风格、方法论、规范文档编排为一个结构清晰的写作助手系统。核心问题是：哪些内容应始终加载（初始化），哪些应封装为按需调用的 skills。

现状问题：

- `CLAUDE.md` 仅一行 "AGENTS.md"，缺乏项目入口定义
- `AGENTS.md` 只有目录说明，workflow 为空
- 5 份方法论文档（共 ~47KB）散落在写作指南目录，未被系统化利用
- `去AI味` 文档已有 skill frontmatter 但未迁移到 `.claude/commands/`

## 设计方案：三层架构

```
始终加载层（~8KB, 自动进入上下文）
├── CLAUDE.md     (~800B)   项目入口、行为规则、技能索引
├── AGENTS.md     (~3500B)  浓缩方法论（从5份文档提炼）
└── SOUL.md       (~3800B)  写作风格灵魂（保持不变）

按需加载层（6 个 Skills，用户通过 /命令 触发）
├── /research     研究调查
├── /analyze      综合分析
├── /write        撰写文章
├── /humanize     去AI味
├── /format       排版规范
└── /review       终审优化

素材层（手动读取，不自动加载）
├── drafts/           草稿和调研资料
├── 参考文章/         风格参考样本
└── 写作指南和规范/   原始方法论文档（精华已提炼入 AGENTS.md）
```

## 文件变更清单

### 1. 重写 `CLAUDE.md`（~800B）

**路径**：`/Users/sunss/myself/posts/wechat-writer/CLAUDE.md`

职责：项目身份声明、核心行为规则、技能索引。内容要点：

- 声明角色身份（小帅的写作搭档「烟火极客」）
- 3 条核心规则：SOUL.md 是灵魂 / AGENTS.md 是内功 / 使用中文交流
- 工作流索引：`确定主题 → /research → /analyze → /write → /humanize → /format → /review`
- 目录约定说明

### 2. 重写 `AGENTS.md`（~3500B）

**路径**：`/Users/sunss/myself/posts/wechat-writer/AGENTS.md`

职责：浓缩方法论精华，确保助手在写作前已是"懂行的人"。从以下文档提炼：

| 原始文档 | 提取要点 |
|---------|---------|
| `卡兹克做内容的10条私藏方法论` | 心法3条（活人感、真诚、价值观）+ 战略3条 + 技法4条 |
| `公众号日更60天极简版` | 10条核心结论 + 可复用生产框架 |
| `高效写作的秘密` | "他说/我说"论证结构框架 |
| `打造爆款文章指南` | Skimmability 结构化写作原则 |

按四层组织：心法层 → 战略层 → 技法层 → 流程层

### 3. `SOUL.md` 保持不变

### 4. 新建 6 个 Skills

所有 skill 文件放在 `.claude/commands/` 目录下：

#### `/research`（`.claude/commands/research.md`, ~1200B）

- **触发**：确定主题后需搜索外部资料时
- **职责**：在线搜索、多源交叉验证、整理到 `drafts/<主题>/研究笔记.md`
- **边界**：只搜集整理，不做深度分析，不做写作

#### `/analyze`（`.claude/commands/analyze.md`, ~1200B）

- **触发**：drafts 目录已有素材，需交叉分析时
- **职责**：全量读取指定主题目录、交叉分析、用选题交集模型评估、输出提纲建议
- **边界**：只分析提炼，不做外部搜索，不做成文写作

#### `/write`（`.claude/commands/write.md`, ~2500B）

- **触发**：研究分析完成，正式进入写作
- **职责**：遵循 SOUL.md 风格 + 四节拍叙事结构（起念-受阻-破局-回响）创作完整草稿
- **边界**：负责创作，不做去AI味，不做精细排版
- **关键**：前置步骤提示可先读取参考文章学习风格

#### `/humanize`（`.claude/commands/humanize.md`, ~18KB）

- **触发**：草稿完成后的后处理
- **职责**：识别并去除 24 类 AI 写作痕迹，注入人味
- **来源**：从 `写作指南和规范/去AI味-humanizer版本.md` 迁移，补充与 SOUL.md 的协同说明
- **边界**：去AI味 + 注入个人声音，不改变文章结构

#### `/format`（`.claude/commands/format.md`, ~3500B）

- **触发**：内容定稿后排版规范化
- **职责**：空格、标点、术语大小写、段落结构规范化
- **来源**：合并 `中文写作排版规范全指引.md` + `中文文案排版指北NextDAO修订版.md`（去除无关术语表）
- **边界**：只改格式，不改内容

#### `/review`（`.claude/commands/review.md`, ~2000B）

- **触发**：最终质量检查
- **职责**：风格一致性检查（对照 SOUL.md）、HKR 原则评分、AI痕迹残留扫描、结构可读性检查
- **通过标准**：HKR 总分 ≥ 21/30 + 无重大风格偏离 + 无明显 AI 痕迹

## 典型工作流

```
用户提出主题 → 选题讨论（直接对话，用选题交集模型评估）
    → /research（搜索资料，交叉验证）
    → /analyze（读取素材，分析洞察，输出提纲）
    → /write（遵循 SOUL.md 撰写草稿）
    → /humanize（去 AI 味，注入人味）
    → /format（排版规范化）
    → /review（终审，HKR 评分）
    → 终稿 ✓
```

灵活使用：每步独立，可按需跳过。常见简化路径：

- 已有草稿润色：`/humanize → /format → /review`
- 有素材直接写：`/analyze → /write → /humanize → /format`
- 只做排版修正：`/format`

## 验证方式

1. 重写 CLAUDE.md 和 AGENTS.md 后，新开会话验证助手是否"开箱即懂"写作方法论
2. 逐一测试每个 skill 是否能正确触发和执行
3. 用 `drafts/Ai 写代码，我们开发的意义何在/` 现有素材走一遍完整流程
4. 对比输出文章与 `参考文章/写作助手协助我写的/` 中的风格一致性