writing-assistant

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Writing Assistant

写作助手

写作助手，两种模式：构思引导（从零开始写）和审校打磨（改已有文章）。

注意：日记写作请使用

diary-assistant

skill。

写作助手提供两种模式：构思引导（从零开始创作）和审校打磨（优化已有文章）。

注意：日记写作请使用

diary-assistant

Skill。

Prerequisites

前置条件

Tool	Type	Required	Install
markdownlint-cli2	cli	No	`npx markdownlint-cli2` (no install needed, used in proofreading step 6)
markdown-lint	skill	No	Included 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-lint	Skill	否	包含在 `npx skills add niracler/skill` 中（用于仓库配置）

请勿在Skill加载时主动校验这些工具。若因工具缺失导致命令失败，请直接引导用户逐步完成安装和配置。

Mode Selection

模式选择

User Intent	Mode	Section
「不知道写什么」「帮我构思」「写游记」「记录 TIL」「写点什么」	Inspiration	Inspiration Mode
「帮我改文章」「检查一下」「润色」「校对一下」「看看文章」	Proofreading	Proofreading Mode

If unclear, ask the user.

用户意图	对应模式	查看章节
「不知道写什么」「帮我构思」「写游记」「记录 TIL」「写点什么」	构思引导模式	构思引导模式
「帮我改文章」「检查一下」「润色」「校对一下」「看看文章」	审校打磨模式	审校打磨模式

若用户意图不明确，请主动询问确认。

Inspiration Mode

构思引导模式

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

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

Core Principles

核心原则

Principle	Description
One question at a time	Design a TodoList of prompts, ask one by one
Confirm before next	User thinks -> writes -> revises -> confirms -> next question
Inspire, don't ghostwrite	Use questions to spark thinking, don't decide content direction

原则	说明
一次提出一个问题	设计一系列提示问题，逐一提问
确认后再推进	用户思考→撰写→修改→确认→进入下一个问题
启发而非代笔	通过问题激发思考，不替用户决定内容方向

Article Type Detection

文章类型识别

User Intent	Type	Framework
「写游记」「记录旅行」	Travel	Departure -> Journey -> Reflection
「记录 TIL」「今天学到」	TIL	Context -> Process -> Solution -> Takeaway
「写点什么」「帮我构思」	General	Trigger -> 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

核心原则

Principle	Description
Discuss before editing	Propose changes for user to choose, don't edit directly
Review by section	Use Markdown headings as checkpoints, 1-2 headings at a time
Inspire, don't decide	Use 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?"

Issue	Symptom	Fix
Background assumption	Uses jargon/acronyms without explanation	Add explanation or footnote
Self-referential	"It's like that thing..." without explaining	Make description concrete
Logic gap	Jumps from A to C	Add transitional explanation
Implicit emotion	"It was so..." without setup	Add context first
Information gap	Assumes reader knows the backstory	Briefly 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":

Issue	Example
Abstract noun as subject	Bad: Income reduction changes life -> Good: He changed his life due to income reduction
Verbose phrasing	Bad: Based on this reason -> Good: Therefore
Weak verbs	Bad: Make a contribution -> Good: Contribute
Preposition pileup	Reduce overuse of linking words
Passive voice abuse	Bad: 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:

Check	Description
Signature expressions	"How to put it", "Actually", "A bit..."
Tone	Self-deprecating openings, parenthetical commentary
Quantification	Use specific numbers for persuasion
Bold restraint	Max 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

写作风格速查

Element	Requirement
Language	Conversational, like chatting with a friend
Paragraphs	One topic per paragraph
Bold	Only at important turns/insights, max 3 per section
Data	Weave into experience, put detailed sources in footnotes
Honesty	Admit 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 - 个人写作风格指南