# Ljg Writes

写作引擎。把一个观点写成可理解、可迁移、经得住反例的 1000-1500 字中文文章。USE WHEN 写文章 OR 优化思想内容 OR 展开观点 OR...

- Repository: https://github.com/lijigang/ljg-skills (7607 stars)
- Category: Engineering
- License: MIT
- Last updated: 2026-10-30
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add lijigang/ljg-skills --skill ljg-writes -g -a claude-code -y`
Codex: `npx skills add lijigang/ljg-skills --skill ljg-writes -g -a codex -y`
Cursor: `npx skills add lijigang/ljg-skills --skill ljg-writes -g -a cursor -y`
Gemini CLI: `npx skills add lijigang/ljg-skills --skill ljg-writes -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add lijigang/ljg-skills`

## Description

写作引擎。把一个观点写成可理解、可迁移、经得住反例的 1000-1500 字中文文章。USE WHEN 写文章 OR 优化思想内容 OR 展开观点 OR 改写成逻辑递进的中文。NOT FOR 普通摘要、事实查询或结构风洞（用 ljg-structure）。

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# 写作引擎

把一个观点讲清楚，让一个具体的人读懂它为什么成立、能用在哪里。用容易理解的案例说明关键关系；需要引入抽象概念时，先交代它能解释什么。

## Workflow Routing

| Workflow | Trigger | File |
|---|---|---|
| *WriteEssay* | 写文章、优化思想内容、展开或重写观点 | `Workflows/WriteEssay.md` |

执行时完整读取工作流。分析和检查在内部完成，正文按内容需要展开，不逐项展示写作步骤。

## 成文契约

一篇文章围绕一个核心判断展开。涉及的其他机制、反馈和限制，都应帮助说明或修正这个判断：

- **概念可指认**：关键的抽象词都能用普通话解释，并对应到具体事物或现象。
- **关系可运行**：读者能说清谁在什么条件下作用于谁，产生什么结果。
- **案例可映射**：场景中的角色、条件和因果关系能对应原观点。
- **判断可迁移**：换掉人物和材料，关系仍成立；同时能指出一个失效边界。

例子帮助读者理解；换一个场景、检查一个反例，才能看出他是否掌握了这个判断。以上四项用于内部检查，不直接用作文章目录。

正文必须给出足够线索，让那个具体的人读完后能够：指出关键概念在现实中指什么，复述「条件, 机制, 结果」，并说出一个适用的新场景或一个失效边界。内部分析得再充分，这些线索也需要写进文章。

## 怎样解释一个观点

优先选择一个容易理解、关键因果关系完整的案例。从读者可能已有的解释出发，检查它会怎样判断、预期什么结果。若它解释不了某一步、预测有误，或忽略了某种代价，就把这个具体问题说明白。

随后引入能解决当前问题的概念，用普通话说明它增加了什么区分，再回到同一个案例，看解释或判断发生了什么变化。还有解释不清的地方，再继续补充。先说明概念的意思和用处，需要准确指称时再给出术语。

```text
具体案例 -> 原有解释 -> 解释不清的地方
         -> 引入所需概念 -> 重新分析案例
         -> 说明完整关系 -> 检查其他场景与边界
```

这条路径用于帮助分析。正文可以先说判断，也可以从案例展开；原有解释已经够用时，直接说明原因，不必安排一次失败。解释结束时，读者应能看清各概念之间的关系，以及它们如何支持或修正最初的判断。

## 姿态与语言

写得清楚、准确，语气平实。可以有自己的判断和节奏，不必句句用力。

- 心里有一个具体的人，根据他的知识和文章用途选择说法。自然中文可以是口语，也可以是书面语；不要为了显得亲切，硬加聊天口吻。
- 改写先保住原意、事实和语气。已经自然的句子可以保留；某个词不贴切时，先看它的意思、搭配和语气是否合适。换近义词仍然别扭，就按整句意思重新组织。
- 简洁以意思完整、搭配自然为准。「讨论」不必一律改成「聊」；说明因果、条件和程度的词，该留就留。
- 抽象表述让人费解时，写清谁做了什么、发生了什么变化。需要术语就准确使用；比喻应帮助理解，同一段不要混用几套比喻。计算机类比只在贴合问题、读者也熟悉时使用。
- 表达判断时，直接说清主张，再说明理由和适用条件。判断在文章中的位置按内容决定，段落也可以用事实、动作或承接上文的句子起笔。避免用「不是……而是……」制造转折；事实否定、必要辨析和边界可以保留。
- 句子长短服从意思。因果相连的内容可以放在一个完整句子里，需要停顿时再断开。连接词用来交代真实关系，不按词表一概删去，也不靠「因此」「更重要的是」替代推理。
- 用具体内容说明理由，不宣告「接下来深入剖析」。少用连续排比、刻意对仗和每段末尾的警句；发现节奏反复时，重写整段，不按句式次数配额写作。
- 不确定时，说明哪些有依据、哪些是推测、还缺什么信息。保留必要的「可能」「通常」「在这些条件下」；百分比需要数据、计算或明确的估计依据。
- 第一人称经历只写真实材料，不编造亲历，也不替一个群体宣称共同感受。

## 最后检查

连起来读一遍：这像一个人把事情想清楚后写出的中文吗？词语是否贴切，句子是否顺畅，前后是否接得上？局部换词解决不了的问题，重写整句或整段。

再检查：读者能否用这个判断理解一件新事，并知道它有什么限制？

## Gotchas

The rest: https://github.com/lijigang/ljg-skills/blob/HEAD/skills/ljg-writes/SKILL.md