yzhao062/agent-style

解决的问题

解决AI代理倾向于生成带有‘AI特征’的文本——例如过度使用连接词、过多使用项目符号、滥用被动语态——这些问题常常导致技术文档缺乏专业写作所需的精确性和清晰度。本项目提供了一种结构化的方法，通过应用已确立的写作标准，使AI代理能够像技术专业人士一样写作。

如何工作

该项目提供了一套精心挑选的21条英文写作规则（12条来自斯特伦克与怀特、奥威尔等权威机构的经典规则，以及9条基于2022–2026年LLM输出观察得出的领域实证规则）。这些规则通过以下两种方式集成到AI代理中：

1. 软性强制：规则在生成时加载到代理的系统提示或项目配置中，引导模型在初稿阶段遵循这些规则。
2. 基于技能的审查：可选的第二轮审计（style-review），对草稿进行规则比对分析，并生成润色后的版本。

适用人群

• AI编码与写作代理（如 Claude Code、Cursor、GitHub Copilot、Aider、Codex）及其用户。
• 代理配置维护者，希望生成的技术文本遵循文献支持的规范，而非通用LLM模式。

主要亮点

• 双轨规则集：结合经典写作指南与2022–2026年LLM输出观察所得的规则。
• 广泛集成：支持多种流行AI工具的适配器，包括 Claude Code、Cursor 和 Copilot。
• 机械验证：包含一项合理性基准测试，显示多个主流模型中‘AI特征’违规显著减少。
• 技术范围：专门针对API文档、设计文档、研究论文和README进行优化，明确排除小说和营销文案。