SuperAPI AI 工具集

write

写作与研究

查看项目

更新于 10-16 09:18

技能介绍

write 是 kntnt/skills 中的一项写作技能,其目标是把一份写作简报(brief)以及简报所指向的素材,转化为目标语言的一篇真实初稿,然后停止。它不承担编辑审阅和校对工作,这些属于另外的独立调用。

用途 该技能用于根据简报和素材生成一篇初稿,并校验其素材忠实度(Source Fidelity)以及任何译文引文的准确性。它只产出初稿,不进行后续的编辑加工。

主要能力

  • 接收自由文本形式的简报,简报可以说明要写什么,也可以指向素材,例如本地路径、URL 或整段粘贴的文本。
  • 支持通过参数指定体裁(--genre)、写作技法(--technique)、语言(--language)、是否附加交接元数据(--frontmatter=yes|no)以及输出目标(--output=response|<path>)。
  • 参数解析遵循明确的优先级顺序:正式调用、素材前置 YAML 中识别的 Kntnt 映射、当前上下文指令、适用的会话上下文、根据请求与素材的推断、参数默认值。某一层级找到的值会抑制其下层级对该参数的取值。
  • 技法与语言不会被推断:技法必须被选中(由调用、映射、指令或已解析体裁指定),语言必须被确定,若请求与素材在语言上存在实质歧义或混杂,会先列出候选并询问,然后才动笔。
  • 体裁若为推断而非指定,则只允许读取已安装体裁资源的开头部分(# <Name> 标题及其下段落)作为参考。
  • 会加载写作契约,包括基础文件、选定的体裁、解析出的技法以及语言解析器返回的 composition 范围;对特定体裁还会加载额外的支持文件。
  • 对 article、casestudy、column、opinion 等体裁,会运行脚本测量初稿的解剖结构,并在最多两轮修复内处理失败项。
  • 通过 source-check.md 对完整初稿进行校验,覆盖素材支持与引文的惯用翻译。
  • 除非关闭,否则会在前置 YAML 中附加交接元数据(kntnt 映射),携带规范化后的体裁、技法和语言。

使用方式 通过 uv 运行脚本,命令形式为 UV_NO_CACHE=1 UV_NO_PROJECT=1 uv run "$HERE/scripts/invoke.py",其中 $HERE 是存放该 SKILL.md 的目录,并把用户在 /write 之后输入的全部内容原样送入标准输入。退出码为 0 时按脚本输出执行;其他退出码时,若属于已知构造错误且可在保留用户请求与权限的前提下修正,则通过同一 shim 提交修正后的调用并从失败边界继续;否则原样展示脚本输出并停止。每条 UV 命令都使用一个全新的私有目录作为 TMPDIR,并在命令结束后(包括失败时)删除该目录。

适用场景 适用于需要根据简报和素材快速生成一篇初稿的写作任务,支持多种体裁与语言,并强调素材忠实度,不编造事实,保留归属、不确定性、范围、时间顺序和因果关系。

限制

  • 只产出初稿,不进行编辑审阅或校对。
  • 不提供就地编辑(In-place Editing),不会替换简报所依据的素材,因此输出路径等于已提供文件时会被拒绝。
  • 技法与语言不会被推断或猜测。
  • 若无法启动新的子代理,会报告能力不满足并停止。
  • 参数值超出允许范围时会被拒绝,不写入、不交付并停止。
  • 关于收费、价格、平台支持等具体信息,资料中暂未提供。