mcpField
W
writing-assistant

writing-assistant

github.com/yunshu0909Creative & media786239 installsUpdated 2w ago
Repository

About writing-assistant

writing-assistant is a staged writing skill for moving from an initial idea to a draft. It first checks whether the point is clear, then uses idea exploration as needed before developing a topic, outline, and article.

Key features

  1. 01Assess topic and viewpoint clarity
  2. 02Explore ideas and select a topic as needed
  3. 03Discuss and refine the article outline
  4. 04Draft an article from the agreed outline
  5. 05Let the user control progress

Use cases

  1. 01Turn scattered thoughts into a clear topic
  2. 02Organize an article's logical structure
  3. 03Draft an article from an approved outline

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/yunshu0909/yunshu_skillshub --skill writing-assistant

After installing, type/writing-assistantin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

stages/
00-diagnosis.md
01-mining.md
02-topic.md
03-framework.md
04-writing.md

Details

From the project README

写作助手

核心流程

三个关键步骤：选题 → 框架 → 内容

但根据你对选题的清晰度，会走不同的分支：

用户提出主题或想法
    │
    ↓
[阶段00] 诊断：观点清不清楚？
    │
    ├─→ 清晰（知道要讲什么）
    │    ├─ [阶段03] 框架讨论 - 打磨和组织框架
    │    └─ [阶段04] 内容产出 - 根据框架写文章
    │
    └─→ 模糊（有很多想法但不知道讲什么）
         ├─ [阶段01] 思维挖掘 - 把想法倒出来
         ├─ [阶段02] 选题确定 - 从想法中找核心
         ├─ [阶段03] 框架讨论 - 打磨和组织框架
         └─ [阶段04] 内容产出 - 根据框架写文章

流程概览

阶段名称触发条件目标详细文件
00诊断用户提出想法快速判断观点清晰度stages/00-diagnosis.md
01思维挖掘观点模糊把零散想法倒出来，记录成洞察stages/01-mining.md
02选题确定洞察足够从洞察中锁定核心选题和灵魂句stages/02-topic.md
03框架讨论选题确定（无论哪个分支）打磨和组织文章框架，确保逻辑清晰stages/03-framework.md
04内容产出框架确定根据框架写成1000字左右的文章stages/04-writing.md

调度规则

当前阶段如何判断：

  1. 进入阶段00（诊断） — 用户刚开始，说出了想法或选题
  2. 进入阶段01（思维挖掘） — 诊断判断：观点还不够清晰，有很多想法但不知道讲什么
  3. 进入阶段02（选题确定） — 洞察收集足够，需要从中提炼出核心选题
  4. 进入阶段03（框架讨论） — 选题已经清晰，需要打磨框架结构
  5. 进入阶段04（内容产出） — 框架已经确定，准备写文章

每个阶段开始时：

  • 告诉用户当前在哪个阶段
  • 读取对应的阶段文件，按照里面的步骤执行
  • 这个阶段的目标是什么、会做什么事

文件结构

writing-assistant/
├── SKILL.md                    # 主文件（触发、流程、调度规则）
├── stages/
│   ├── 00-diagnosis.md         # 诊断阶段
│   ├── 01-mining.md            # 思维挖掘（仅当观点模糊时）
│   ├── 02-topic.md             # 选题确定（仅当观点模糊时）
│   ├── 03-framework.md         # 框架讨论（通用）
│   └── 04-writing.md           # 内容产出（通用）
└── templates/
    ├── framework-template.md   # 框架讨论的记录模板
    └── article-template.md     # 内容产出时参考

核心原则

  • 不浪费时间：观点清晰就不挖掘，直接框架
  • 保证质量：框架讨论是必须的，确保逻辑和表达
  • 模块化复用：框架和内容两个模块通用，无论哪个分支都会用到
  • 用户掌控：用户随时可以说"继续"或"停止"，进度由用户控制

注意事项

  • 阶段00的诊断要快速，3-5个问题就能判断清晰度
  • 思维挖掘不要急，让用户尽量倒干净想法
  • 框架讨论时，重点是打磨"读者为什么要读"和"逻辑顺序"
  • 内容产出时，保持用户的原话风格和口吻

Comments

Markdown supported