Skip to content
Back to search

technical-writing

中文内部技术写作的 agent skill,约束设计文档 / 评审稿 / postmortem / 分享稿场景的语气、句法、结构

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/luoling8192--technical-writing/badge.svg)](/listings/luoling8192--technical-writing)

HTML

<a href="/listings/luoling8192--technical-writing"><img src="/api/listings/luoling8192--technical-writing/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

通过 [skills.sh](https://skills.sh) 一行装,自动检测当前 agent 并写入对应目录:

npx skills add luoling8192/technical-writing

支持 Claude Code、Cursor、Codex、GitHub Copilot、Windsurf、Gemini、Cline、AMP 等主流 agent runtime。装完在对应 agent 里用 Skill 工具调用 `technical-writing` 即可,也可以在项目的 CLAUDE.md / AGENTS.md 里把它列为常用 skill。

手动安装(fallback)

如果不想用 skills.sh,可以直接 clone 后软链接:

git clone https://github.com/luoling8192/technical-writing.git ~/repos/technical-writing
mkdir -p ~/.claude/skills
ln -s ~/repos/technical-writing ~/.claude/skills/technical-writing

OpenAI Codex 用户可参考 `agents/openai.yaml`,按 Codex 文档注册到本地。

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 600 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: technical-writing
  3. description: Use when drafting or revising internal technical design docs, review notes, architecture writeups, or sharing posts in Chinese, especially when the tone should stay evidence-backed, calm, and suitable for peers or leaders rather than marketing or literary writing.
  4. ---
  5. # Internal Technical Writing
  6. ## Overview
  7. Use this skill when the writing target is an internal技术方案、评审稿、架构说明、分享文稿,重点在于把背景、猜想、证据、抽象、实现影响面讲清楚。
  8. 这类写作更接近技术汇报,不是宣传稿,也不该写成散文。语气要平稳,判断要有来路,段落要能顺着问题往下读。
  9. ## When to Use
  10. - 在写内部技术方案、设计说明、评审文档、分享稿
  11. - 在改一篇已经有内容、但文风过满、结论过快、证据不足的技术文章
  12. - 在解释代码、模块边界、架构演进、可观测性、评测方法
  13. - 在把聊天记录、讨论结论整理成可传播的技术文档
  14. **When not to use**
  15. - UI 文案、按钮文案、产品营销稿
  16. - 面向外部用户的帮助文档
  17. - 纯粹的 API reference 或机械说明书
  18. ## Core Stance
  19. 先接住读者,再往下解释。
  20. 常见写法是作者替读者抢先下判断,像 `很清楚`、`说明了`、`显然`、`真正`。这里更适合换成三步:
  21. 1. 我们观察到了什么
  22. 2. 基于这些观察,可以归纳出什么
  23. 3. 这些归纳暂时更适合落在哪类实现或组织方式里
  24. 如果要给出更强的判断,至少满足下面任一条件:
  25. - 前文已经提出了对应的猜想,这一段是在 callback
  26. - 同一段上下文里已经有交叉验证的 evidence
  27. - 已经引用了具体模块、代码、issue、trace、指标或实验结果
  28. 这些 bad case 往往有同一种共性:
  29. - 句子承担的是“主持文章”的功能,不是“推进论证”的功能
  30. - 句子在表达作者感受,不是在交代条件、对象、约束或判断
  31. - 句子把英文抽象写作习惯直接投到了中文里
  32. - 句子删掉以后,不影响事实,不影响论证,也不影响结构
  33. 遇到这类句子,默认处理方式不是“换个更文雅的说法”,而是:
  34. 1. 先判断这句是否真的提供信息
  35. 2. 如果不提供信息,直接删除
  36. 3. 如果提供信息,就把信息改写成条件、对象、关系、结果
  37. ## Preferred Structure
  38. 写长文时,优先用这条主线:
  39. `背景 -> 拆解现状 -> 提出猜想 -> 分节解答 -> 回指前文 -> 影响面 -> 可观测性 / eval -> 收束`
  40. 如果文章围绕一个系统展开,可以把每一节都写成“在回答前面哪个问题”。这样读者会知道当前段落在解决什么,而不是只看到一串观点。
  41. 更具体一点,常见结构会是:
  42. - 先交代背景和目标
  43. - 拆现状,尤其是已有系统的优势、局限、宏观规律
  44. - 把猜想或设计问题提出来
  45. - 逐节解释每一层能力怎样补上
  46. - 回到代码、模块、数据流、观测面和评测面
  47. 如果某一节表面上在讲模块,实际目的是在替另一个概念安家,可以优先用这种结构:
  48. 1. 先用一个很短的 quote 收住上下文
  49. 2. quote 里优先放 `mindmap` 或极简结构图
  50. 3. 再给一个生命周期或时序图
  51. 4. 最后才进入正文,解释这个概念为什么放在这里、怎样和现有模块对上
  52. 如果要给 leader 或评审一个放在最开头的 TL;DR,优先用三段结构:
  53. 1. 先讲启发来源或背景变化
  54. 2. 再讲当前系统已经具备哪些输入、还缺哪一层结构
  55. 3. 最后讲新模块设计和架构决策
  56. 这个 TL;DR 只保留三类信息:
  57. - 原因
  58. - 猜想
  59. - 决策
  60. 不要在 TL;DR 里复述整篇目录,也不要解释作者接下来会怎么写。
  61. ## Language Rules
  62. 中文语气以自然、平实、技术同伴之间的说明为主。
  63. - 中文引用统一用 `「」`
  64. - 少用修辞和比喻,尤其是面对前线开发和内部评审
  65. - 少用居高临下的口吻,避免说教感
  66. - 少写成议论文式对抗句,优先顺着读者的理解路径展开
  67. - 专有概念按正式名字书写,大小写保持稳定,例如项目里的 `Collector`、`Scheduler`、`Alert` 这类专名,全文统一一种写法
  68. - 指标、能力、链路这些名词先钉住,再配动词和形容词;优先复用已经确定的词系,例如 `流通性`、`筛选`、`聚合`、`命中`,不要临时拼接近义词
  69. - 不要写口语化的过场句,例如 `聊到这里`、`继续往下看`、`这条方向很值得继续推开`、`先把这件事单独拿出来说`、`最后可以用一句话收住`;如果一句话只是在主持文章,不承载信息,就直接删掉
  70. - 少用空评价词,例如 `很现实`、`很重`、`很轻`、`很顺`;改成具体约束、具体风险、具体影响
  71. 下面这类句型要主动收一层:
  72. - `不是……而是……`
  73. - `不在……而在……`
  74. - `为什么?原因其实很直接`
  75. - `这条路径已经很清楚了`
  76. - `说明了一件事`
  77. - `自然会`
  78. - `真正`
  79. 更稳妥的写法通常是:
  80. - `也许你会先想到……`
  81. - `把视线收回到今天的代码里,会先看到几组比较稳定的规律`
  82. - `顺着这些模块往回看,可以归纳出……`
  83. - `前面提到的猜想,在这里开始有了一个更具体的回答`
  84. - `先把判断放轻一些,后面再结合代码或指标继续说明`
  85. 遇到段落里的关键问题句,可以适度用 `**...**` 强调,但只留给真正的主问题,不要把普通判断句全部加粗。
  86. ## Buzzword Blocklist
  87. 下面这些词在中文技术文档里几乎都是「让句子看起来有信息,但读完不知道发生了什么」。看到先停一下,能换成具体动作 / 对象 / 约束就换掉。
  88. 原则:不是逐词替换,而是逐句重写。原句里如果只有黑话词承载信息,整句通常没信息。删掉看论证少不少东西,少了再补具体的,没少就让它消失。
  89. ### 抽象抢戏词
  90. - `生态` / `生态位` / `产品生态` → 列出具体依赖关系、用户类型或集成方
  91. - `赋能` / `赋能用户` → `让用户能 X` / `把 X 能力开放给 Y`
  92. - `闭环` / `形成闭环` → `X 之后 Y 也接进去了` / `现在能从 A 走到 B 再回到 A`
  93. - `抓手` / `核心抓手` → `我们能改的那一个变量是 X`
  94. - `心智` / `用户心智` / `心智模型` → `用户在第一次看到 X 时会怎么想 / 怎么操作`
  95. - `链路打通` / `打通` → `A 现在能调用 B` / `A 写入的数据 B 也能读到`
  96. - `沉淀` / `沉淀经验` / `沉淀方法论` → `记录到 docs/X` / `整理成 skill / runbook`
  97. - `落地` / `落地能力` / `落地场景` → `在 A 模块实现` / `在 B 业务用上`
  98. - `心力` / `认知负担` → `需要记住 X 个步骤` / `上手要先理解 Y`
  99. - `收口` / `统一收口` → `所有 X 都走 Y 一个入口`
  100. - `加持` / `AI 加持` → `加了 X 之后能 Y` / `在 X 步用了 LLM`
  101. - `底座` / `底层逻辑` → `基础设施层是 X` / `这件事成立的前提是 Y`
  102. ### 评价腔 / 主持腔
  103. - `很值得` / `非常值得` → 给具体理由:值得在哪个维度上
  104. - `极致` / `极致体验` → 改成具体指标:延迟降到多少、步骤减到几步
  105. - `丝滑` / `顺畅` → 改成具体约束:哪步原本卡,现在跳过了
  106. - `深度集成` / `深度对接` → 改成集成点的具体范围
  107. - `一站式` → `在 A 入口能完成 B / C / D`
  108. - `颠覆` / `重塑` → 默认不用;真要用得有 before / after 对比
  109. ## Evidence-First Writing
  110. 写代码和架构时,避免直接把实现细节翻译成抽象结论。
  111. 推荐顺序:
  112. `代码 / issue / trace / metric -> 宏观规律 -> 抽象归纳 -> 设计判断`
  113. 例如,不要直接写:
  114. > 当前代码里,这条路径已经很清楚了。
  115. 更适合写成:
  116. > 把视线收回到今天的代码里,会看到几组比较稳定的宏观规律。顺着这些模块往回看,可以先归纳出一个较稳定的结构。前面提到的几层能力,也因此开始有了几种更适合继续承接的实现位置。
  117. ## Reader-Aware Explanations
  118. 很多技术分歧来自“作者默认读者已经接受了自己的前提”。这里更适合先猜测读者可能会怎么想,再把误会拆开。
  119. 常用句法:
  120. - `也许你会先想到定时巡检,像是……`
  121. - `顺着这个方向想下去,会发现我们更关心的是……`
  122. - `这样理解,会更贴近这次设计的边界`
  123. 适合接一个 quote:
  124. > 一条巡检任务如何按预定周期扫描每个指标
  125. 然后再转入你真正要讨论的问题:
  126. > 持续涌入的原始日志,怎样在不拖慢写入链路的情况下,被判定成一条值得通知的告警
  127. ## Few-Shot Fixes
  128. 下面这些例子比抽象规则更重要。写作时如果遇到类似句式,优先按这个方式改。
  129. ### 1. 不要把英文里的 `real / realize / reality` 直接翻进中文
  130. 原句:
  131. > 一旦把告警规则接到多个采集端上,粒度问题会马上变得很现实。
  132. 问题:
  133. - `现实` 在这里不是合适的表语
  134. - 主语是 `粒度问题`,谓语是 `变得`,搭配不成立
  135. - 句子像是在表达感受,不是在说明约束
  136. 改写:
  137. > 可以预见的是,告警规则接入多个采集端之后,规则粒度的控制会很重要。
  138. 为什么这样改:
  139. - 先写条件:`接入多个采集端之后`
  140. - 再写对象:`规则粒度的控制`
  141. - 最后写判断:`会很重要`
  142. ### 2. 不要用空评价词替代约束
  143. 原句:
  144. > 这样的组合很顺。
  145. 问题:
  146. - `很顺` 只有情绪,没有信息
  147. - 读者不知道顺在成本、链路、延迟还是模块边界
  148. 改写:
  149. > 这种组合更接近实际分工。
  150. 或者:
  151. > 这种组合能把日志写入链路和告警判定链路拆开。
  152. 为什么这样改:
  153. - 直接说分工关系
  154. - 或者直接说结构变化
  155. - 不用作者主观感受替代技术判断
  156. ### 3. 不要用对立句法硬造强调
  157. 原句:
  158. > 它值得认真看的地方,不在宣传语,而在它把一组采集与告警机制组织得很完整。
  159. 问题:
  160. - `不在……而在……` 容易写出说教感
  161. - 读者还没进入正文,就先被作者带去站队
  162. 改写:
  163. > 更值得认真拆开的,是它把一组采集与告警机制组织得比较完整。
  164. 为什么这样改:
  165. - 少掉对立结构
  166. - 句子仍然保留重音
  167. - 读者更容易直接进入后文
  168. ### 4. 不要用过场句替代内容
  169. 原句:
  170. > 聊到这里,告警去重相关的模型也该放进来一起看了。
  171. 问题:
  172. - 这是主持人口吻,不是技术文档
  173. - 删掉这句,论证不会损失任何信息
  174. 改写:
  175. > 告警去重相关的模型也需要放进来一起讨论。
  176. 为什么这样改:
  177. - 直接进入主题
  178. - 不拿过场句占正文位置
  179. 同类句子也直接删掉,不做“温和改写”:
  180. 原句:
  181. > 先把「压缩」这件事单独拿出来说。
  182. 问题:
  183. - 这是主持句,不提供任何新信息
  184. - 删掉之后,后文论证不受影响
  185. 处理:
  186. > 直接删除,让下一句作为段落开头
  187. ### 5. 不要把“主持文章”的句子写进正文
  188. 原句:
  189. > 这张图想说明的事情很简单。
  190. 问题:
  191. - 这是主持句,不提供图外的新信息
  192. - 读者真正需要的是图后的结论,不是作者先出面做导语
  193. 处理:
  194. > 直接删除,下一句直接解释图里的结构关系
  195. 原句:
  196. > 接下来进入这一节真正关心的问题:
  197. 问题:
  198. - 这句话只是在带节奏,没有补充任何事实
  199. - 如果下一句本身已经是问题句,这一句就没有存在价值
  200. 处理:
  201. > 直接删除,或者把下一句改成完整的问题句
  202. 原句:
  203. > 最后可以用一句更轻一点的话结束:
  204. 问题:
  205. - 这句话只是在管理作者自己的写作动作
  206. - 正文里不需要暴露作者“现在准备收尾”
  207. 处理:
  208. > 直接删除,让引文或结论直接出现
  209. ### 6. 论证有顺序,就直接写成 1. 2. 3. 4.
  210. 原句:
  211. > 第一,采集端很多,但日志最终还是会被收束到告警引擎。
  212. > 第二,采集层已经承担了日志归一化……
  213. > 第三,告警引擎自己已经天然拥有一组规则边界……
  214. > 第四,外围模块已经把不少有价值的事件散落出来了……
  215. 问题:
  216. - 如果只是散写四段,读者不容易看出这是一组并列论据
  217. - 论据顺序和论证强度不够醒目
  218. 改写:
  219. 1. 采集端很多,但日志最终还是会被收束到告警引擎。
  220. 2. 采集层已经承担了日志归一化、字段提取、标签注入、来源标注。
  221. 3. 告警引擎自己已经拥有一组稳定的规则边界。
  222. 4. 外围模块已经给出了足够多的事件与状态。
  223. 为什么这样改:
  224. - 论证顺序被显式标出来
  225. - 每一点都能单独成立
  226. - 后文更容易 callback
  227. ### 7. 指标名和动作词要属于同一套语义系统
  228. 原句:
  229. > 第一组命题靠近转化率。不同 source 类型进入系统之后,有多少被 dedupe 掉,有多少在 cooldown 里停住,有多少被 policy 接住,最后又有多少真的升级成一条告警。
  230. 问题:
  231. - `转化率`、`dedupe 掉`、`停住`、`接住`、`升级` 混了多套词
  232. - 指标名和动作词不在一个语义系统里
  233. 改写:
  234. > 1. 计算流通性。
  235. > 不同 source 类型进入系统之后:
  236. > - 有多少被 dedupe 筛选
  237. > - 有多少进入 cooldown 聚合
  238. > - 有多少被 policy 命中
  239. > - 最后又有多少升级成一条告警
  240. 为什么这样改:
  241. - 先钉住指标名:`流通性`
  242. - 再统一动作词:`筛选 / 聚合 / 命中 / 升级`
  243. - 这一组词能互相支撑,不会彼此打架
  244. ### 8. 表面在讲模块,实际是在给概念安家时,先给短图
  245. 原句:
  246. > 从采集入口到告警判定层……
  247. > 后面直接开始解释告警引擎、采集层、规则模块……
  248. 问题:
  249. - 读者还不知道这节到底想回答什么
  250. - 容易把“解释模块”写成“复习已有系统”
  251. 改写结构:
  252. 1. 先点明问题:`这一节表面上在讲告警引擎,真正要回答的是去重模块应该放在哪里。`
  253. 2. 用一个很短的 `mindmap` 收住周边模块
  254. 3. 再给一个生命周期图
  255. 4. 最后才写 `1. 2. 3. 4.` 论据,把概念安到现有系统上
  256. 为什么这样改:
  257. - 图负责建立工作机理
  258. - 正文负责回答设计问题
  259. - 模块介绍不会挤掉概念论证
  260. ### 9. TL;DR 先讲启发来源,再讲问题定义,最后讲模块设计
  261. 原句结构:
  262. > 当前系统已经具备了大量可利用的信息来源……
  263. > 我们的猜想是……
  264. > 基于这个判断,我们的决策是……
  265. 问题:
  266. - 起手就落在“系统现状”,重心太平
  267. - 启发来源没有先出现,读者不容易立刻进入问题
  268. - `基于这个判断,我们的决策是` 也带一点主持口吻
  269. 更合适的结构:
  270. > 第一段:先讲外部启发或上游项目带来的变化
  271. > 第二段:再讲日志、指标、trace、事件等输入已经存在,系统接下来要整理的是反复出现、需要聚合的重复告警
  272. > 第三段:直接提出新模块设计,以及消息队列、异步消费框架这类架构决策
  273. 例子:
  274. > 上游某个监控项目让大家看到了另一种告警形态……
  275. > 当前系统也已经具备了足够多的输入和状态来源……
  276. > 这里提出一个新的模块设计……
  277. 为什么这样改:
  278. - 第一段先建立背景和动机
  279. - 第二段再定义问题
  280. - 第三段直接落到决策
  281. - 读者扫三段就能抓住全文主轴
  282. ### 10. 不要把作者感受写成技术判断
  283. 原句:
  284. > 这样的组合很顺。
  285. 原句:
  286. > 这条路径很清楚。
  287. 原句:
  288. > 这会马上变得很现实。
  289. 问题:
  290. - `顺`、`清楚`、`现实` 都是作者感受,不是技术判断
  291. - 读者不知道到底顺在什么、清楚在哪里、约束是什么
  292. 改写方向:
  293. > 先写条件
  294. > 再写对象
  295. > 最后写判断
  296. 例如:
  297. > 可以预见的是,告警规则接入多个采集端之后,规则粒度的控制会很重要。
  298. ### 11. 不要把结构写成隐喻动作
  299. 原句:
  300. > 散落出来了
  301. 原句:
  302. > 收拢出来
  303. 原句:
  304. > 往一层里收
  305. 原句:
  306. > 延展下去
  307. 原句:
  308. > 停在 action skipped
  309. 原句:
  310. > 落在 failed
  311. 问题:
  312. - 这些词在脑子里成立,是因为作者把系统想成了“流动中的东西”
  313. - 一旦写成中文,主谓和宾语关系经常不成立
  314. - 它们会把“状态”“结构”“结果”误写成“位置”或者“动作”
  315. 改写方向:
  316. - `提供了`
  317. - `整理出来`
  318. - `集中到同一层处理`
  319. - `继续追加后续处理`
  320. - `最终生成了 action skipped`
  321. - `最终生成了 failed`
  322. ## Lists, Quotes, and Flow
  323. 不要为了“像文章”而硬把所有东西写成整段 prose。内容本来就是 list-shaped 时,直接列出来更清楚。
  324. 适合列出来的内容:
  325. - 设计目标
  326. - 猜想
  327. - 模块影响面
  328. - 待补充实现点
  329. - 评测命题
  330. - 适用 / 不适用场景
  331. 如果一组判断本身带有论证顺序,优先直接写成 `1. 2. 3. 4.`,不要把它们散落成几段并列 prose。
  332. 适合用 quote 的内容:
  333. - 想强调的命题
  334. - 读者可能先想到的另一种问题定义
  335. - 控制论 / 系统论 / issue 摘录中的关键句
  336. 适合用箭头的内容:
  337. - `event -> dedupe -> alert`
  338. - `background -> hypothesis -> answer`
  339. - `collect -> match -> notify`
  340. ## Module-Level Writing
  341. 只谈抽象很容易飘。只谈代码又会失去设计视角。内部技术文档通常需要两层一起出现:
  342. - 抽象层:概念、边界、语义、主张
  343. - 实现层:模块、类型、采集器、规则、存储、trace、eval
  344. 写实现层时,尽量把模块面摊开:
  345. - 哪些模块已经存在
  346. - 哪些模块只体现出局部规律
  347. - 哪些模块更适合作为后续替代实现
  348. - 哪些地方需要补偿、迁移、压缩、解耦
  349. 如果一段在说“改造”或“补充实现”,优先给出可扫描的块,例如:
  350. > 可能涉及到的补充实现:
  351. > - 告警存储层 CRUD 拓展
  352. > - 告警编排从 inline 转向异步消费
  353. > - tracing 压缩与聚合策略
  354. > - 可观测面板的链路展示与命题聚合
  355. ## Tone Calibration
  356. 面向内部评审、leader、前线开发时,语气以「一起拆问题」为主。
  357. - 少下定论,多给出推演路径
  358. - 少用绝对化副词,多用 `先`、`可以`、`暂时`、`顺着这个观察`
  359. - 少写审判式句子,多写解释式句子
  360. - 少写“作者赢了”的结尾,多写“读者可以继续往下跟”的结尾
  361. ## Editing Checklist
  362. 交稿前,逐项扫一遍:
  363. - 有没有没有证据支撑的强判断
  364. - 有没有 `不是……而是……` 一类对立句法
  365. - 有没有 `很清楚 / 说明了 / 显然 / 真正` 这种抢结论的词
  366. - 有没有把代码直接翻译成抽象结论
  367. - 有没有只讲概念,不讲模块和影响面
  368. - 有没有该列清单的地方却硬写成长段
  369. - 有没有前文提出的猜想,后文却没有 callback
  370. - 指标名、动作词、状态词有没有混用,名词和动词是不是同一套语义系统
  371. - 有没有过场句在替内容占位置;如果删掉一句话不影响论证,就直接删掉,不改写成另一句过场话
  372. - 中文引号有没有统一成 `「」`
  373. ## Default Prompting Pattern
  374. 收到草稿时,先做三件事:
  375. 1. 标出文中最强的几个判断
  376. 2. 检查这些判断有没有 callback 或 evidence
  377. 3. 按 `背景 -> 猜想 -> 解答 -> 回指` 重排结构,再改句子
  378. 如果需要给出改写建议,优先直接改成可用的句子,不要只做抽象点评。
README.md · README · 54 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # technical-writing
  2. 中文内部技术写作的 agent skill。约束设计文档、评审稿、postmortem、分享稿等场景的语气、句法、结构,让产出贴近技术汇报,避开营销稿和散文气质。
  3. ## 适用场景
  4. - 写内部技术方案、设计说明、评审文档、分享稿
  5. - 改一篇文风过满、结论过快、证据不足的技术文章
  6. - 把聊天记录、讨论结论整理成可传播的技术文档
  7. - 解释代码、模块边界、架构演进、可观测性、评测方法
  8. 不适用:UI 文案、产品营销稿、面向外部用户的帮助文档、机械 API reference。
  9. ## 安装
  10. 通过 [skills.sh](https://skills.sh) 一行装,自动检测当前 agent 并写入对应目录:
  11. ```bash
  12. npx skills add luoling8192/technical-writing
  13. ```
  14. 支持 Claude Code、Cursor、Codex、GitHub Copilot、Windsurf、Gemini、Cline、AMP 等主流 agent runtime。装完在对应 agent 里用 Skill 工具调用 `technical-writing` 即可,也可以在项目的 CLAUDE.md / AGENTS.md 里把它列为常用 skill。
  15. ### 手动安装(fallback)
  16. 如果不想用 skills.sh,可以直接 clone 后软链接:
  17. ```bash
  18. git clone https://github.com/luoling8192/technical-writing.git ~/repos/technical-writing
  19. mkdir -p ~/.claude/skills
  20. ln -s ~/repos/technical-writing ~/.claude/skills/technical-writing
  21. ```
  22. OpenAI Codex 用户可参考 `agents/openai.yaml`,按 Codex 文档注册到本地。
  23. ## 核心约束
  24. - 先观察,再归纳,再判断,不抢结论
  25. - 中文里不用破折号 `—` 和英文连字符 `-` 做分句
  26. - 中文引号统一用 `「」`
  27. - 不要黑话连篇(完整词表见 SKILL.md 的 Buzzword Blocklist)
  28. - 不写抢结论的词、空评价词、对立句法、过场句、英文翻译腔
  29. - 结构信息直接用 list,论证顺序用 `1. 2. 3. 4.`
  30. - 长文主线:背景 → 拆解现状 → 提出猜想 → 分节解答 → 回指前文 → 影响面 → 可观测性 / eval → 收束
  31. 完整规则、改写示例、Few-Shot 修正案例见 [`SKILL.md`](./SKILL.md)。
  32. ## Credits
  33. 灵感和反馈来自 [@nekomeowww](https://github.com/nekomeowww)。
  34. ## License
  35. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.