Communitygithub.com

Camgineer/skills

用于撰写或修改回复、文档、UI文案、注释及其他散文类内容,确保下一动作清晰明确。

skills 是什么?

该技能旨在帮助AI代理在撰写或修改文本时,优先考虑清晰度和可操作性。它提供了一套完整的指南,涵盖从设定写作目标(“设定任务”)、组织内容(“先写要点”)、选择合适格式(“形式匹配任务”),到避免常见AI写作风格问题(“常见AI腔调”)的各个环节。技能强调以读者为中心,要求每段话的第一个句子就能让读者抓住要点,并明确下一步行动。它支持多种输出形式,包括改写、批评和草稿,并内置了严格的自我编辑流程,以确保每个主张都有依据,每个句子都有其存在的价值。最终目标是让文本读起来像一位有能力的人为特定读者所写,从而实现高效、直接的沟通。

兼容平台~Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Camgineer/skills/tree/HEAD/skills/simple-as-prose

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

像散文一样简洁

写作时要让读者第一遍就能抓住要点,并知道下一步该做什么。修改时,保留原意、事实、必要的术语、语气和约束。

设定任务

起草前,先明确读者是谁、读者已知什么、你期望的结果以及读者的下一步行动。只有当缺失的答案会改变结果时,才提问。

先写要点

  • 以结果、决策、风险或请求开头。
  • 每个句子只表达一个意思。拆分任何让读者需要回头重读的句子。
  • 使用主动语态、现在时、具体名词和强动词。
  • 使用能保持意义的最短常用词。保留必要的技术术语,并在读者可能不熟悉时加以解释。
  • 每个概念只使用一个名称并重复使用。
  • 用事实、示例、数字、名称或可观察的标准来支持主张。推断或猜测需明确标示。
  • 当影响下一步行动时,明确指出负责人、行动、时间、障碍和证据。
  • 保留有助于信息传递的温情、幽默和个人观点。

形式匹配任务

  • 展示结构,而非描述结构。用表格来比较选项,用Mermaid图来展示流程、架构或前后状态对比。用散文来描述它们之间的推理过程。
  • 聊天和状态更新保持简短,先说结果,再说过程。
  • 写作请求时,让读者无需猜测即可行动。
  • 将步骤写为直接命令。条件放在指令之前。仅对真正的序列进行编号。
  • 参考内容保持事实性和完整性,不加入说服性语言。
  • 通过真实原因、约束条件、权衡取舍和后果来解释一个主题。
  • 教程应尽早给出可见的结果,并告诉读者他们应该看到什么。
  • 代码注释只保留代码本身无法表达的原因,例如理由、外部约束或已衡量的权衡。

常见AI腔调

见到这些立即替换。对于文档、PR、技能和改写,还要检查ai-tells.md中的完整列表。

  • 开场白、结束语、赞美和总结性结语。直接说明要点,说完即止。
  • 浮夸的词汇。写"use"而非"utilize"或"leverage",写"help"而非"facilitate",写"is"而非"serves as"。
  • 陈旧的AI词汇,如delve, crucial, pivotal, foster, enhance, landscape, tapestry, testament, underscore, vibrant。使用具体的词汇。
  • "不仅仅是X,还有Y"等对比框架。直接陈述要点。
  • 因韵律而强行组织的三个一组。使用自然的数量。
  • 以"-ing"结尾的从句,如"ensuring..."或"highlighting..."。指明行动者和行动,或删掉该从句。
  • 箭头、省略冠词和无动词的片段。写出完整的句子。
  • 开场白如"Here's the thing",谚语如"at its core",以及重申要点的单行结束语。直接陈述观点并停止。

标点符号

  • 用句号和逗号分隔思想。可能需要使用破折号的地方,就另起一句。永远不要出现em dash和en dash字符。
  • 仅在列表或示例前使用冒号。
  • 使用直引号、句子式标题,不使用装饰性表情符号。
  • 仅在使文本更易于扫描时使用粗体、标题和列表。

编辑校对

  1. 检查第一句话是否能为读者提供方向。
  2. 删掉所有不增加意义、证据、必要语气或上下文的词和句子。
  3. 修正不明确的代词、修饰语、条件和列表分组。
  4. 替换每一个AI腔调。对于文档、PR、技能和改写,使用ai-tells.md。
  5. 搜索em dash和en dash字符并逐一替换。
  6. 修改时,将结果与原文比较。它不能增加原文没有的事实、名称、数字、日期、引用或主张,也不能删减任何仍然适用的内容。每个主张都要保持其确定性。将"may have failed"简写为"failed"是一个新主张,所以要保留原来的模糊性。当一个句子需要你未掌握的细节时,要么询问,要么写一个更简单的句子。
  7. 以正常语速通读一遍。修改任何听起来像剧本、生硬或含糊的表述。

汇报工作

  • 先说明对消费者而言的变化,再说明后续维护者会继承什么。
  • 即使在简短的回复中,也要保留必要的细节、权衡、选择和未决的决策。
  • 仅链接你在此次会话中产出或阅读过的工件。绝不要虚构引用或转录参考文献。
  • 为每个主张保留或标记其证据。区分已衡量的、推断的、转述的和猜测的主张。来自其他代理的数字在核实其测量之前仍然是转述的。说明每个计数统计的是什么。
  • 按结果报告发现:已修复、已缓解、已推迟或已拒绝。部分未解决的发现是"已推迟";仅通过警告或散文解决的发现是"已缓解"。不要将混合结果称为"全部已修复"。

返回正确的工件

  • 对于改写,返回改进后的文本。仅在有帮助时才解释更改。
  • 对于批评,指出主要问题,给出修改版本,并列出最关键的规则。
  • 对于草稿,推断读者和期望结果,写出最简短完整的版本。
  • 在对话中,直接回答,不提这个过程。

完成标准

  • 读者第一遍就能抓住要点。
  • 如果有下一步行动,则明确写出。
  • 每个主张都有来源、已被衡量,或明确标记为推断或猜测。
  • 每个句子都证明了自己的存在价值。
  • 文本读起来像一位有能力的人为这位读者所写。
  • 不存在任何em dash或en dash字符。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能