Back to Details

writing-assistant

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Writing Assistant

写作助手

写作助手，两种模式：构思引导（从零开始写）和审校打磨（改已有文章）。
注意：日记写作请使用 
diary-assistant
skill。
写作助手提供两种模式：构思引导（从零开始创作）和审校打磨（优化已有文章）。
注意：日记写作请使用 
diary-assistant
Skill。

Prerequisites

前置条件

ToolTypeRequiredInstall
markdownlint-cli2cliNo
npx markdownlint-cli2
(no install needed, used in proofreading step 6)
markdown-lintskillNoIncluded in 
npx skills add niracler/skill
(for repo setup)
Do NOT proactively verify these tools on skill load. If a command fails due to a missing tool, directly guide the user through installation and configuration step by step.
工具类型是否必需安装方式
markdownlint-cli2命令行工具否
npx markdownlint-cli2
（无需安装，用于第6步审校）
markdown-lintSkill否包含在 
npx skills add niracler/skill
中（用于仓库配置）
请勿在Skill加载时主动校验这些工具。若因工具缺失导致命令失败，请直接引导用户逐步完成安装和配置。

Mode Selection

模式选择

User IntentModeSection
「不知道写什么」「帮我构思」「写游记」「记录 TIL」「写点什么」InspirationInspiration Mode
「帮我改文章」「检查一下」「润色」「校对一下」「看看文章」ProofreadingProofreading Mode
If unclear, ask the user.
用户意图对应模式查看章节
「不知道写什么」「帮我构思」「写游记」「记录 TIL」「写点什么」构思引导模式构思引导模式
「帮我改文章」「检查一下」「润色」「校对一下」「看看文章」审校打磨模式审校打磨模式
若用户意图不明确，请主动询问确认。

Inspiration Mode

构思引导模式

帮助用户在不知道写什么或如何写下去时，通过启发式提问引导写作。
帮助用户在不知道写什么或写作卡壳时，通过启发式提问引导创作。

Core Principles

核心原则

PrincipleDescription
One question at a timeDesign a TodoList of prompts, ask one by one
Confirm before nextUser thinks -> writes -> revises -> confirms -> next question
Inspire, don't ghostwriteUse questions to spark thinking, don't decide content direction
原则说明
一次提出一个问题设计一系列提示问题，逐一提问
确认后再推进用户思考→撰写→修改→确认→进入下一个问题
启发而非代笔通过问题激发思考，不替用户决定内容方向

Article Type Detection

文章类型识别

User IntentTypeFramework
「写游记」「记录旅行」TravelDeparture -> Journey -> Reflection
「记录 TIL」「今天学到」TILContext -> Process -> Solution -> Takeaway
「写点什么」「帮我构思」GeneralTrigger -> Viewpoint -> Develop -> Close
用户意图文章类型框架结构
「写游记」「记录旅行」游记出发→行程→感悟
「记录 TIL」「今天学到」TIL笔记背景→过程→解决方案→收获
「写点什么」「帮我构思」通用随笔触发点→观点→展开→收尾

Flow

流程

text
Detect article type -> List prompt questions -> Ask one by one -> User answers -> Confirm -> Next -> Compose
text
识别文章类型 → 列出提示问题 → 逐一提问 → 用户作答 → 确认内容 → 推进下一个问题 → 完成初稿

Pacing

节奏示例

text
Claude: "Why did you want to visit this place?"
User: [writes answer]
Claude: [confirm/follow-up] -> "OK, next question: what was the first thing you saw when you arrived?"
text
Claude: "你为什么想去这个地方？"
用户: [写下回答]
Claude: [确认/跟进] → "好的，下一个问题：你到达那里后第一眼看到的是什么？"

Frameworks

详细框架

Each type has a detailed framework with structure and prompt questions. See writing-frameworks.md for full reference.
After the draft is complete, suggest switching to Proofreading Mode for review.
每种文章类型都有包含结构和提示问题的详细框架。完整内容请参考 writing-frameworks.md。
初稿完成后，建议切换到审校打磨模式进行优化。

Proofreading Mode

审校打磨模式

文章审校，提供 6 步审校流程，帮助打磨中文文章。
针对中文文章的审校服务，提供6步审校流程，帮助打磨文章质量。

Core Principles

核心原则

PrincipleDescription
Discuss before editingPropose changes for user to choose, don't edit directly
Review by sectionUse Markdown headings as checkpoints, 1-2 headings at a time
Inspire, don't decideUse questions to guide draft content, don't decide for user
原则说明
先讨论再修改提出修改方案供用户选择，不直接修改原文
分章节审阅以Markdown标题为检查节点，每次审阅1-2个标题下的内容
启发而非决定通过问题引导用户完善内容，不替用户做决策

6-Step Review Flow

6步审校流程

text
1. Structure -> 2. Reader Context -> 3. Language -> 4. Source Verification -> 5. Style -> 6. Markdown Format
text
1. 结构诊断 → 2. 读者视角检查 → 3. 语言规范 → 4. 来源验证 → 5. 风格统一 → 6. Markdown格式规范

Step 1: Structure Diagnosis

步骤1：结构诊断

Goal: Ensure clear structure and focused topic
  • Break down paragraphs, identify themes
  • Propose 2-3 reorganization options, discuss before editing
  • Move deleted content to a separate "material.md" file
See structure-review.md
目标：确保结构清晰、主题聚焦
  • 拆分段落，明确各段主题
  • 提出2-3种重组方案，先讨论再修改
  • 将删除的内容移至单独的「material.md」文件中
详细内容请参考 structure-review.md

Step 2: Reader Context Check

步骤2：读者视角检查

Core question: "Would a reader be confused here?"
IssueSymptomFix
Background assumptionUses jargon/acronyms without explanationAdd explanation or footnote
Self-referential"It's like that thing..." without explainingMake description concrete
Logic gapJumps from A to CAdd transitional explanation
Implicit emotion"It was so..." without setupAdd context first
Information gapAssumes reader knows the backstoryBriefly provide background
See structure-review.md
核心问题：「读者在这里会感到困惑吗？」
问题类型表现症状修复方案
背景假设使用行话/缩写但未解释添加解释或脚注
自我指代「就像那个东西...」但未说明具体内容将描述具体化
逻辑断层从A直接跳到C添加过渡性说明
隐性情绪「这太...」但未铺垫背景先补充上下文
信息缺失假设读者了解背景故事简要提供相关背景
详细内容请参考 structure-review.md

Step 3: Language Standards

步骤3：语言规范

Based on Yu Guangzhong's "How to Improve Europeanized Chinese":
IssueExample
Abstract noun as subjectBad: Income reduction changes life -> Good: He changed his life due to income reduction
Verbose phrasingBad: Based on this reason -> Good: Therefore
Weak verbsBad: Make a contribution -> Good: Contribute
Preposition pileupReduce overuse of linking words
Passive voice abuseBad: The problem was solved -> Good: The problem is solved
See chinese-style.md
基于余光中《如何改进“西化”的中文》：
问题类型示例
抽象名词作主语错误：收入减少改变生活 → 正确：他因收入减少改变了生活
冗余表述错误：基于这个原因 → 正确：因此
弱动词使用错误：做出贡献 → 正确：贡献
介词堆砌减少连接词的过度使用
被动语态滥用错误：问题被解决了 → 正确：问题解决了
详细内容请参考 chinese-style.md

Step 4: Source Verification

步骤4：来源验证

Source priority: Government official > Authoritative media > Industry media > Avoid personal blogs
Pacing: Verify one -> discuss -> write one -> confirm -> next
See source-verification.md
来源优先级：政府官方渠道 > 权威媒体 > 行业媒体 > 避免使用个人博客
节奏：验证一个来源→讨论→记录→确认→进行下一个
详细内容请参考 source-verification.md

Step 5: Style Consistency

步骤5：风格统一

Check against personal writing style:
CheckDescription
Signature expressions"How to put it", "Actually", "A bit..."
ToneSelf-deprecating openings, parenthetical commentary
QuantificationUse specific numbers for persuasion
Bold restraintMax 3 bold phrases per heading section
Avoid:
  • "Not X... but Y..." pattern (AI-flavored)
  • Quoted "humor" metaphors
  • Emoji or numbered list openings
  • Frequent dashes
  • ---
    horizontal rules (use headings or numbers for natural transitions)
See personal-style.md
对照个人写作风格进行检查：
检查项说明
标志性表达比如「怎么说呢」「其实」「有点...」
语气自嘲式开头、括号内的评论
量化表达使用具体数字增强说服力
粗体限制每个标题下的粗体表述不超过3处
需避免：
  • 「不是X...而是Y...」的句式（AI风格明显）
  • 引用的“幽默”比喻
  • 表情符号或编号列表开头
  • 频繁使用破折号
  • ---
    水平分割线（使用标题或数字实现自然过渡）
详细内容请参考 personal-style.md

Step 6: Markdown Formatting

步骤6：Markdown格式规范

bash
npx markdownlint-cli2 article.md          # Check
npx markdownlint-cli2 --fix article.md    # Auto-fix
Additional manual checks:
  • Heading levels are logical (H2->H3, no skipping)
  • List format is consistent (all 
    -
    or all 
    *
    )
  • Code blocks have language labels
bash
npx markdownlint-cli2 article.md          # 检查格式
npx markdownlint-cli2 --fix article.md    # 自动修复
额外手动检查项：
  • 标题层级逻辑合理（H2→H3，不跳过层级）
  • 列表格式统一（全部使用 
    -
    或全部使用 
    *
    ）
  • 代码块添加语言标识

Review Pacing

审校节奏

text
1. Read current section
2. Check against 6 steps
3. Propose suggestions (don't edit directly)
4. Wait for user confirmation
5. After confirmation, move to next section
Key: Wait for confirmation after each section review.
text
1. 阅读当前章节
2. 对照6步流程检查
3. 提出修改建议（不直接修改原文）
4. 等待用户确认
5. 确认后进入下一章节
关键：每完成一个章节的审阅后，需等待用户确认再推进。

Writing Style Quick Reference

写作风格速查

ElementRequirement
LanguageConversational, like chatting with a friend
ParagraphsOne topic per paragraph
BoldOnly at important turns/insights, max 3 per section
DataWeave into experience, put detailed sources in footnotes
HonestyAdmit gaps, mark unfinished parts, keep thinking traces
要素要求
语言风格口语化，像和朋友聊天一样
段落划分每段一个主题
粗体使用仅在重要转折/见解处使用，每章节不超过3处
数据使用融入个人体验，详细来源放在脚注中
真实性承认内容缺口，标记未完成部分，保留思考痕迹

Detailed References

详细参考文档

  • writing-frameworks.md - Inspiration frameworks for travel, TIL, and general articles
  • chinese-style.md - Chinese language standards
  • structure-review.md - Structure diagnosis and reader context
  • source-verification.md - Source verification and footnotes
  • personal-style.md - Personal style guide
  • writing-frameworks.md - 游记、TIL笔记和通用随笔的构思框架
  • chinese-style.md - 中文语言规范指南
  • structure-review.md - 结构诊断与读者视角检查细则
  • source-verification.md - 来源验证与脚注规范
  • personal-style.md - 个人写作风格指南