technical-writing
中文内部技术写作的 agent skill。约束设计文档、评审稿、postmortem、分享稿等场景的语气、句法、结构，让产出贴近技术汇报，避开营销稿和散文气质。
适用场景
- 写内部技术方案、设计说明、评审文档、分享稿
- 改一篇文风过满、结论过快、证据不足的技术文章
- 把聊天记录、讨论结论整理成可传播的技术文档
- 解释代码、模块边界、架构演进、可观测性、评测方法
不适用：UI 文案、产品营销稿、面向外部用户的帮助文档、机械 API reference。
安装
通过 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 文档注册到本地。
核心约束
- 先观察，再归纳，再判断，不抢结论
- 中文里不用破折号
—和英文连字符-做分句 - 中文引号统一用
「」 - 不要黑话连篇（完整词表见 SKILL.md 的 Buzzword Blocklist）
- 不写抢结论的词、空评价词、对立句法、过场句、英文翻译腔
- 结构信息直接用 list，论证顺序用
1. 2. 3. 4. - 长文主线：背景 → 拆解现状 → 提出猜想 → 分节解答 → 回指前文 → 影响面 → 可观测性 / eval → 收束
完整规则、改写示例、Few-Shot 修正案例见 SKILL.md。
Credits
灵感和反馈来自 @nekomeowww。
License
MIT