SuperAPI AI 工具集

writing

写作与研究

查看项目

更新于 10-24 16:19

技能介绍

writing 是一套面向技术写作的纪律与规范,目标是产出清晰、高密度、反冗余(anti-slop)的文字。它既适用于人类作者,也适用于 AI 代理在生成文档时遵循。

用途:解决 AI 代理常见写作问题——通过训练语料中的模式匹配插入防御性前言(如“下表概述……”)、重复可从源码直接推导的易变常量、叙述显而易见语法(如“// 递增 i”)、以及用单调说教的语气稀释技术实质。目标状态是:每份文档一次阅读即可传达作者的确切决策与技术推理,标题后直接进入有效载荷,不含任何易腐或装饰性内容。

主要能力(不变式指南):

  • 直接载荷不变式:从领域标题直接过渡到技术载荷(表格、代码块、列表、模式),不写过渡性前言或功能叙述。
  • 目的先于手段:在给出流程或机制之前,先说明目标或要解决的问题。
  • 无易腐信息:不在 Markdown 中重复可从代码、锁文件或类型签名推导出的信息。
  • 每文档单一主题:将参考事实(references/)、流程手册(usecases/)和概念解释分开。
  • 每句一个可执行决策:每句只承载一个关键指令,避免人和代理略过次要要求。

使用方式:该技能提供执行工作流,包括 ai-context(为 AI 代理起草高信号上下文文档,如 SKILL.md、AGENTS.md、CLAUDE.md)和 readme-md(编写精简、高转化、尊重读者时间的项目 README.md)。同时包含领域参考:purpose-before-means(排序规则,让读者先理解目标再理解实现)、no-perishable-information(消除易漂移的代码数据重复)、purpose-and-reason(每条规则配对底层机械理由)、rhythm(设计可扫描的文本节奏与可扫读性)。还委派给其他技能:humanity-and-humanness(尊重人类认知加工与推理阅读)、poteto-principles(最小化读者负担、先减后加)、anti-slop-engineering(遵循 Gate 3 品味、视觉克制与干净 UI 微文案,以及 Gate 0 零推测性文档)。

适用场景:撰写技术文档、PR 摘要、提交信息、架构记录、面向 AI 代理的上下文文件(SKILL.md、AGENTS.md、CLAUDE.md)以及项目 README.md。

限制:资料未提供具体安装命令、收费模式、平台支持或效果保证;该技能为写作规范与指南,不包含自动化执行工具或代码生成功能。