返回资讯中心
外部精选
软件工程
#开发者实时流

开源项目推出面向AI代理的专业写作技能

来源标题:A Writing Skill for Agents

一个名为Human-readable writing的便携式代理技能发布,用于指导AI代理撰写专业文本。该技能以Markdown文件分发,不含脚本,支持Claude Code、Codex、OpenCode、Pi和oh-my-pi等运行时,但验证覆盖因运行时不同而异。其写作指导涵盖研究笔记、财务分析、投资评论、政策备忘录等场景,要求模型把压缩的名词短语改写为说明"谁做什么"的句子,并保留技术术语和来源事实。

Hacker News 最新narnia09812026/11/11 · 6 天前24 分钟阅读

以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。

面向人类阅读的写作是一项可移植的 agent 技能,服务于专业写作。项目面向 Claude Code、Codex、OpenCode、Pi 和 oh-my-pi,验证覆盖范围因运行时不同而不同。其写作指导涵盖研究笔记、财务分析、投资评审、政策备忘录、设计记录、PR 描述和事故更新。目标是帮助读者把论断与证据、条件和实际后果联系起来。

该技能的指令以 Markdown 文件形式分发。安装后的包中不包含任何脚本。指令要求模型把压缩的名词短语改写成说明“谁做什么”的句子。指令还要求模型保留技术术语和来源事实,把每个条件和不确定性放在它所限定的论断旁边,并按读者任务的需要组织信息。当来源对某一关系的表述不清晰时,指令要求模型就此提问,而不是凭空编造一个关系。

该技能起初是个人写作工具,其评估也有限。已记录的检查表明,它能在特定运行时版本中加载,并且少数输出保留了来源事实。它对人类理解度、阅读时长或整体写作质量的提升尚未得到证实。

这个 PR 描述是一个示例,用来展示预期的修改。它不是某次已记录运行的输出。

为防止在登出后 profile 响应到达时先前用户的数据重新出现,本变更将屏幕更新限制为:请求开始时捕获的 sessionVersion 与响应到达时的当前值相匹配,且该值在登出时递增。进行中的请求不会被取消,且该行为仅在浏览器中验证过。

登出后到达的 profile 响应可能把先前用户的数据重新放回屏幕。本变更通过在登出时递增 sessionVersion 来防止这一点。当响应到达时,应用仅在请求开始时保存的版本仍与当前版本匹配时才更新屏幕。

进行中的请求不会被取消。该行为仅在浏览器中验证过。

修订后的版本先说明问题和修复方式,然后解释应用何时保存、更改和比较版本。版本匹配条件、未取消的进行中请求以及仅在浏览器中验证这几点仍然明确写出。

示例页面补充了修订请求以及每个修订版本保留的事实。页面还展示了一次记录在带日期的运行时检查中的事故更新,以及该检查的局限。

研究解读、财务分析、资本投资、政策评估和架构决策都配有英文和韩文的专业示例,包含原始草稿、已记录的修订、来源和保真度评审。

以下 CLI 示例选择 Codex 和 Claude Code。请在你要使用该技能的项目根目录下运行:

npx skills add JangHyun-bin/human-readable-writing --skill human-readable-writing -a codex -a claude-code

该命令仅为该项目安装该技能。Codex 从 .agents/skills/ 读取它,Claude Code 从 .claude/skills/ 读取它。只保留你所用 agent 对应的 -a 选项。

对于 Pi,把 agent 选项换成 -a pi;Pi 也使用 .agents/skills/。对于 oh-my-pi,请使用手动安装指南。OpenCode 也是目标之一,但当前支持不完整。CLI 支持某个 agent 并不代表该技能在每种配置下都能正常工作。安装后请启动一个新会话。

若要改为安装到你的用户账户、让每个项目都能使用该技能,请加上 -g:

npx skills add JangHyun-bin/human-readable-writing --skill human-readable-writing -a codex -a claude-code -g

2026-11-02 的运行时检查未覆盖用户级安装。当前安装检查请参见 verification。

skills CLI 会发送匿名使用数据。对于像本仓库这样的公开 GitHub 仓库,数据包括仓库名和技能名。要关闭该功能,请在运行 CLI 时设置 DISABLE_TELEMETRY=1。CLI 的遥测说明给出了详细信息。

安装指南涵盖从克隆仓库手动安装、更新、卸载和迁移。早先的说明曾把仓库根目录链接到 skills 目录中。该技能现在位于 skills/human-readable-writing/,因此请按指南所述替换那些链接。

使用表中对应运行时的调用方式,并附上你要编辑的文本。下面的示例使用 Claude Code;写作指令在各运行时之间是共享的。

/human-readable-writing Revise this PR description for a maintainer. Preserve the technical terms, facts, conditions, and uncertainty. [Paste the description here.]

请显式使用该技能;各运行时在选择技能的方式上有所不同。指令要求模型遵循你要求的语言和格式,并保留标识符、数量、单位、排除项、否定表述和不确定性。这些指令并不强制每段只写一句话。有一次已记录的 OpenCode 运行更改了来源中的一个条件,因此在使用前请将每个结果与其来源进行比对。

写作规则没有针对特定运行时的副本。工具支持文档描述了全部五个目标的安装路径、观测到的行为以及仍需完成的兼容性工作。

2026-11-10 的分发快照在项目作用域和用户作用域下用 Claude Code 2.1.321、Pi 1.4.0 和 oh-my-pi 18.18.6 进行了测试。原生 Codex 0.167.0 无法用测试账户验证,因为其 provider 拒绝了所选的模型。分发验证记录保留了这些结果。

2026-11-11 的专业示例使用 Claude Code 2.1.322 和 claude-sonnet-5-5,以及该包的隔离项目副本。它们不增加对其他运行时或安装作用域的覆盖。

(原文较长,此处译出前 6000 字,完整内容请点「打开原文」。)

正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。

打开原文
去社区讨论 →