AI 技术文章写作

硬性规则

• 正文标题 ## 01、标题，标题只写名称，不加冒号和后缀解释
• 列表只用于短小并列的项目（工具清单、检查项、对照表），成段的内容用段落展开，不要连续几个章节都用列表
• 叙述句和对话引导不用冒号，冒号只用于列表引导句、列表项的“术语：解释”和简历字段名；不用破折号
• 正文叙述不出现项目自定义类名（AgentBudget、McpServerManager），用中文功能描述代替，类名只在代码块里出现
• 读者是有经验的 Java 后端开发，熟悉 AI Agent，Kafka 消费者、位移、死信队列、CAS、Full GC、令牌桶、熔断、topK 这类常见概念直接用，不加解释。只解释项目自定义的东西和不常见的术语，工具名、角色名、参数名第一次出现时说清是什么、谁在用
• 零歧义，读者不需要多想一步。指代写成具体对象，主语、宾语写全，不用需要先翻译一遍的比喻，不生造术语
• 用户纠正过的用词和禁用词收在 scripts/wording_rules.py，由检查脚本执行，新的纠正追加进去，同时补进 references/human-tone.md「词语」表
• 量化数据和时间估算必须有出处（源码、文档、实测），没有出处就用模糊表达，禁止编造精确数字
• 技术断言要么有出处，要么标注“我的推断是”。正文直接讲消化后的事实，不复述“帖子里说”“官方介绍”，出处放进交付给用户的来源清单
• 模型和产品举例用最新的（Fable 5.1、Opus 5.5、Sonnet 5.5、GPT-6 Astra、GPT-6 Luna、DeepSeek V4、GLM-5.3），AI Coding 工具用 Claude Code、Codex、Qoder 举例；热点词汇先查清当下业界的真实所指
• 不写没有来源的场景细节（时间、天气、神态、对白）
• 不用翻案腔，也就是先立一个读者并没有的误解，再推翻它给下文抬价。“不是A，而是B”“你以为A，其实B”“看似A，实则B”都是它的变形，修法是把判断从正面直接说出来。文章确实用一手材料走完了从误解到修正的过程时可以写，但不套这些句式。直接引文里的违禁内容改成间接引述
• 章节和答案按因果往前推进，前一段的结论引出后一段的问题，不用“三层原因”“分三步”这类分类代替叙述（题目本身问的就是分层结构时除外）
• 不写总结段和升华句，事情讲完就停