Help users get started writing when they don't know what to write or how to continue, guiding them through heuristic questions.
Note: For diary writing, please use the diary-assistant skill; this skill focuses on travelogues, TILs, and general articles.
Core Principles
| Principle | Description |
|---|---|
| Don't ask everything at once | Design heuristic questions as a TodoList and ask them one by one |
| Confirm before continuing | Only after the user has thought it through → written it → revised it → confirmed it do you move to the next question |
| Inspire rather than write for them | Use questions to inspire thinking; do not decide the content direction for the user |
Article Type Identification
| User Intent | Type | Framework |
|---|---|---|
| "Write a travelogue", "record a trip" | Travelogue | Departure → Journey → Reflection |
| "Record a TIL", "learned today" | TIL | Background → Process → Solution → Takeaways |
| "Write something", "help me brainstorm" | General | Origin → Viewpoint → Elaboration → Conclusion |
Process
识别文章类型 → 列出启发问题 → 逐个提问 → 用户回答 → 确认 → 下一个 → 整理成文
Questioning Rhythm
Claude: 「为什么想去这个地方？」
用户: [写下回答]
Claude: [确认/追问] → 「好的，下一个问题：到达时第一眼看到什么？」
Travelogue Framework
Structure
1. 出发前
- 为什么去这个地方？
- 有什么期待？
2. 旅途中
- 按时间线或地点组织
- 感官体验（看到、听到、闻到、尝到）
- 文化冲击 / 意外发现
- 心理变化
3. 回来后
- 最深刻的印象是什么？
- 有什么改变了你的认知？
- 会推荐别人去吗？为什么？
Heuristic Questions
Senses
- What is the first thing you saw when you arrived?
- What smell left a deep impression on you?
- What special thing did you eat?
Experience
- What surprised you?
- What was different from what you expected?
- Was there any awkward or interesting experience?
Reflection
- What did this trip give you a new understanding of?
- If you could do it again, how would you plan it?
- Was there any regret or surprise?
TIL Framework
Structure
1. 背景
- 遇到了什么问题？
- 为什么需要解决？
2. 过程
- 尝试了什么方法？
- 踩了什么坑？
3. 解决方案
- 最终怎么解决的？
- 关键代码/配置是什么？
4. 收获
- 学到了什么？
- 下次遇到类似问题怎么办？
Heuristic Questions
- How was this problem discovered?
- What did you initially think the cause was?
- What keywords did you search for?
- Which answer/documentation helped you?
- Are there any pitfalls to remind your future self about?
General Article Framework
Structure
1. 起因
- 为什么想写这个话题？
- 有什么触发点？
2. 观点
- 你的核心观点是什么？
- 有什么支撑这个观点的经历/数据？
3. 展开
- 有哪些角度可以讨论？
- 有没有反面观点？
4. 收尾
- 你希望读者带走什么？
- 有什么行动建议？
Heuristic Questions
Opening
- If you had to summarize this article in one sentence, what would you say?
- What is the one thing you most want readers to know?
Elaboration
- Is there a specific example you can use to illustrate it?
- Would anyone disagree with your viewpoint? What would they say?
- How did you arrive at this conclusion?
Conclusion
- After writing this article, what new understanding do you have?
- Is there anything you haven't figured out yet?
Detailed Reference
For the complete framework and more heuristic questions, see frameworks.md。