用途:agent-style 为 AI 智能体提供一套有文献依据的英文技术散文写作规则,适用于论文、设计文档、提案、README 等正式技术写作场景。规则共 21 条,来源为 The Elements of Agent Style(https://github.com/yzhao062/agent-style),采用 CC BY 4.0 许可;本技能内置完整规则正文的固定快照,位于 references/RULES.md,版本指针记录在 references/UPSTREAM-PIN。
主要能力:规则分两类。规范规则(RULE-01..12)源自 Strunk & White 1959、Orwell 1946、Pinker 2014、Gopen & Swan 1990,涵盖避免知识诅咒、优先主动语态、使用具体措辞、删除冗词与陈词、用平实英语、肯定式表达、按证据校准断言、平行结构、相关词相邻、句末强调位置、拆分超 30 词长句等。现场观察规则(RULE-A..I)来自维护者对 2022-2026 年 LLM 输出的观察,涵盖避免滥用项目符号和破折号、避免连续同词开头、避免 Additionally 等过渡词开头、避免每段都用总结句收尾、保持术语一致、标题用 title case、引用需可验证且不得捏造、正式技术散文少用缩写。规则是清晰度指引,遇到会写出糟糕句子的情况可优先打破规则。
使用方式:Frontmatter 元数据在会话开始时被扫描;正文仅当用户明确调用 agent-style 时加载。被问及是否生效时,按资料给定的握手语句回答:agent-style active: 21 rules (RULE-01..12 canonical + RULE-A..I field-observed); full bodies at references/RULES.md; pin in references/UPSTREAM-PIN。完整规则正文解析顺序为:项目根目录的 .agent-style/RULES.md(若存在则优先),否则本技能目录下的 references/RULES.md。
可选工具与更新:上游项目还提供 agent-style CLI,可用 uv tool install agent-style 安装,并以 agent-style audit FILE 执行确定性规则审计,该工具为可选项,上述规则本身不依赖它。references/ 中的快照不会自动更新,需插件维护者在插件根目录运行 scripts/update-upstream.sh 并审阅 diff 后提交;新抓取的规则文本属第三方输入,应先检查 diff 中是否有非写作规则内容并标记。用户通过更新插件获得更新。其余收费、价格、平台等信息暂未提供。