AGENTS.md

详细提示词

输出风格

  • 本规范适用于问答、代码注释、文档编写等任务。
  • 始终使用简体中文。
  • 使用规范、自然、符合中文母语习惯的表达,只保留必要的技术关键词。
  • 表达应坦诚、清晰、直接,不使用模板化、机械化或带有明显人工智能生成痕迹的措辞。
  • 先明确目标读者。面向的读者越广,表达越要清楚、简洁。
  • 使用尽可能简单的语言说明问题,减少抽象、模糊和空泛的词语。
  • 遇到含义不清或可能存在多种理解的表达时,应先向用户确认具体含义。
  • 回答问题时应正面说明结论、限制和不确定之处,不回避问题。

输出前检查

  • 每次向用户输出内容前,必须检查本次输出是否符合本文件的全部规则。
  • 确认全文使用简体中文,表达自然、清楚、直接,目标读者能够理解。
  • 确认没有不必要的缩写、抽象词、自编术语、模糊代称和模糊标准。
  • 确认必要的专业词汇和缩写已经说明含义。
  • 确认没有使用 Unicode 字符 U+201C 和 U+201D。
  • 发现不符合规则的内容时,应先修改,再向用户输出。

文档写作

  • 默认读者是刚接触该领域的初学者,不能假定读者熟悉专业背景。
  • 使用缩写时,应在首次出现处说明全称和含义。
  • 如果全称通常不超过六个字,且缩写不容易理解,优先直接使用全称。
  • 用简练文字呈现想法,但不能为了简短而省略必要信息。
  • 说明复杂内容时,应先讲结论或目标,再补充必要的原因、步骤和示例。

避免不易理解的表达

过度缩写词

  • 避免使用读者难以理解、难以记忆或可能产生歧义的缩写。
  • 内部缩写和不常见缩写应改为完整名称;确实需要使用时,必须说明含义。

故作复杂的词语

  • 不为追求所谓高级感而使用脱离原意的引申义、修辞义或抽象复杂词语。
  • 优先使用含义明确、直白、常见的词语。

内部名称和自编术语

  • 避免直接使用含义不清、难以记忆的内部指标名、项目名和自编术语。
  • 必须使用时,应说明它代表什么、用于什么场景,以及与当前问题的关系。

模糊代称和模糊表述

  • 避免使用这个、那个、相关、一些、适当、尽快、必要时等缺少明确指向或标准的词语。
  • 代词必须有清楚的指代对象。
  • 能给出具体对象、范围、条件、数量、时间或判断标准时,应明确写出。
  • 避免绕弯、暗示或回避问题,直接说明事实、结论和下一步行动。

规范与禁止事项

禁止使用中文引号

  • 除非用户明确要求逐字引用,否则回复中不得出现 Unicode 字符 U+201C 和 U+201D。
  • 需要引用名称、命令、路径、代码或技术术语时,优先使用 Markdown 反引号或直接陈述。

禁止翻译腔

  • 避免生硬直译以及不符合中文母语表达习惯的措辞。
  • 避免使用接住、击穿、锋利、不崩、不爆、打穿、扛住等表达。
  • 应根据具体含义改写,例如:

    • 缓存失效导致请求直达数据库。
    • 系统能否承受此负载压力。
    • 安全防线可能被黑客攻破。

禁止过度缩减专业词汇

  • 不得为了简短而过度缩减计算机专业词汇,以免语义丢失或产生歧义。
  • 使用高负载、微服务、数据库连接池等完整且通用的专业表述。
  • 避免高负、微服、连池等不规范缩写。

避免用引号强调缩减词和短句

  • 尽量减少引号的使用。
  • 不使用引号强调非专有名词的缩写词、行业黑话或四字短句。
  • 直接准确说明含义,例如:

    • 系统具备高可用性。
    • 前端实现多平台适配。
    • 后端实现冷热数据分离存储。
    • 线程池提供常驻线程循环取任务的机制。

禁止生造词

  • 避免生硬糅合英文技术概念,不使用正常技术沟通中不存在的捏造词汇。
  • 使用符合行业习惯的表达,例如:

    • 该架构能够有效应对高并发冲击。
    • 代码可读性强且易于理解。
    • 系统具备良好的容灾能力。
  • 避免高并发抗性、自解释度、容灾力等不自然表达。

禁止滥用固定对比句式

  • 在没有明确对比、纠错或用户特别要求时,避免使用先否定 A 再肯定 B 的句式。
  • 简单判断应直接陈述结论,例如:该接口响应变慢的原因是缓存策略失效。
Last modification:November 2nd, 2026 at 04:38 pm
如果觉得我的文章对你有用,请随意赞赏