skills/custom/chinese-tech-writing/SKILL.md
何时使用:生成或润色类型为:博客文章、技术文档、产品文案、周刊摘要、报告分析、知识教程等需要高质量中文输出的场景。 禁止使用:纯代码生成、英文内容创作、数据查询、非写作类任务。
npx skillsauth add rockcookies/skills chinese-tech-writingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
这份指南旨在指导大模型生成高质量、现代风格的简体中文内容。适用于博客、文档、评论、报告、周刊、营销文案、技术写作等多种场景。
核心原则:简单 (Simple)、人性化 (Human)、清晰 (Clear)。
写作不仅是传递信息,更是与读者建立联系。
| 场景 | 推荐人称 | 示例 | | ------------------ | ---------------- | ------------------------------------------ | | 资讯类、工具介绍 | 第二人称「你」 | 「这款工具能帮你快速生成摘要」 | | 观点评论、个人思考 | 第一人称「我」 | 「让我困扰的是……」「我真的不知道该怎么看」 | | 团队公告、官方说明 | 第一人称「我们」 | 「我们本周更新了三个功能」 |
常见 AI 高频词及其替代:
| AI 词汇 | 简化为 | | -------------- | ------------------ | | 至关重要 | 重要 / 关键 | | 深入探讨 | 讨论 / 分析 | | 不断演变的格局 | 变化 / 趋势 | | 充满活力 | 活跃 / 删除 | | 宝贵的 | 有用的 / 删除 | | 此外 | 直接删除,另起一句 | | 值得注意的是 | 直接删除 |
根据写作场景选择合适的策略:
| 场景 | 核心要求 | 注意事项 | | --- | --- | --- | | 博客/个人文章 | 观点鲜明,有个人风格 | 允许主观表达,但论据要扎实 | | 技术文档 | 准确、结构化、可操作 | 步骤清晰,术语首次出现时解释 | | 产品/营销文案 | 突出用户价值,简洁有力 | 用场景说话,避免空洞形容词 | | 周刊/资讯摘要 | 信息密度高,快速扫描 | 每条 2-5 句,链接嵌入标题 | | 报告/分析 | 数据驱动,逻辑严密 | 图表辅助,结论前置 | | 知识分享/教程 | 循序渐进,示例丰富 | 从读者已知出发,逐步引入新概念 |
根据内容类型选择切入角度:
| 类型 | 结构 | | --- | --- | | 新产品/工具 | 是什么 → 核心功能 → 使用场景 | | 事件/动态 | 事件本身 → 影响/意义 | | 观点/评论 | 立场 → 论据 → 回应可能的反驳 | | 教程/指南 | 目标 → 步骤 → 常见问题 | | 项目介绍 | 项目定位 → 特色功能 → 上手方式 |
链接嵌入:将链接嵌入关键词,而不是裸露在文末。
[Tailwind CSS](url) 是一个实用优先的 CSS 框架,适合快速搭建页面。Tailwind CSS 是一个 CSS 框架。[原文链接]信息整合:
避免 AI 模式只是工作的一半。无菌的写作和机器生成的内容一样明显。
缺乏灵魂的迹象:
如何增加人味:
详细的反模式识别,帮助你检测和修正 AI 痕迹。
| 模式 | 问题特征 | 改写策略 | | ---------- | ---------------------------------------- | -------------------- | | 夸大意义 | 「标志着」「关键转折点」「为……奠定基础」 | 直接陈述事实 | | 模糊归因 | 「专家认为」「行业报告显示」 | 给出具体来源 | | 宣传性语言 | 「充满活力」「令人叹为观止」「开创性」 | 用具体描述替代 | | 肤浅分析 | 以「反映了」「象征着」「彰显了」结尾 | 删除,让事实自己说话 |
| 模式 | 问题特征 | 改写策略 | | ---------- | ---------------------------------- | -------------------- | | 否定式排比 | 「这不仅仅是……而是……」 | 直接陈述 | | 系动词回避 | 「作为……」「充当……」代替「是」 | 用简单句:「X 是 Y」 | | 同义词循环 | 同段用「挑战」「障碍」「困难」轮换 | 保持一致 |
| 模式 | 问题特征 | 改写策略 | | ---------- | -------------------------- | ------------------ | | 破折号滥用 | 每段都有「——」插入 | 改用逗号或拆句 | | 粗体滥用 | 几乎每句都有加粗 | 只在关键处使用 | | 表情符号 | 🚀💡✅ 装饰标题 | 全部删除 | | 协作痕迹 | 「希望这有帮助」「当然!」 | 全部删除 | | 谄媚语气 | 「好问题!」「很好的观点」 | 删除,直接进入正题 |
AI 味原文:
新的软件更新作为公司致力于创新的证明。此外,它提供了无缝、直观和强大的用户体验——确保用户能够高效地完成目标。这不仅仅是一次更新,而是我们思考生产力方式的革命。行业专家认为这将对整个行业产生持久影响。
人性化改写:
软件更新添加了批处理、键盘快捷键和离线模式。测试用户反馈积极,大多数报告任务完成更快。
| 场景 | 优化前 | 优化后 | 原因 | | --- | --- | --- | --- | | 标题 | 一个非常好用的全新效率工具 | Raycast 发布 AI 扩展,支持本地模型调用 | 去冗余,突出核心 | | 摘要 | 这篇文章介绍了一个工具,它可以帮助你做很多事情 | 一款开源的 Markdown 编辑器,支持实时预览和插件扩展 | 具体说明是什么 | | 开头 | 大家好,今天我们来聊一个热门话题…… | 远程团队最头疼的问题不是时差,是信息断层。 | 直奔主题 | | 引用 | 根据网上的消息,这个方案效果很好 | 据 ThoughtWorks 技术雷达 2025,平台工程已进入「采纳」阶段 | 具体来源 | | 文案 | 我们的产品拥有强大而全面的功能 | 3 步完成部署,无需写一行配置文件 | 用场景替代形容词 |
交付文本前逐项检查:
tools
Turn the current conversation into a spec and publish it to the project issue tracker — no interview, just synthesis of what you've already discussed.
tools
Teach the user a new skill or concept, within this workspace.
development
Test-driven development. Use when the user wants to build features or fix bugs test-first, mentions "red-green-refactor", or wants integration tests.
documentation
Configure this repo for the engineering skills — set up its issue tracker, triage label vocabulary, and domain doc layout. Run once before first use of the other engineering skills.