用途:为项目内所有 Markdown 文档提供统一的格式与写作风格标准,在生成或编辑文档时使用。不适用于源代码、代码注释等场景。
主要能力与规则: 格式方面,要求无拼写错误;避免表情符号和装饰性 Unicode 字符(如 →、•、★、✓、🎯、✅);避免用连字符或破折号分隔概念,遇到“概念 A - 概念 B”应改写句子;优先使用列表和表格而非长段落;文档保持简洁,规格说明与 ADR 控制在 1 至 2 页;自由文本中不要使用 #<数字>(如“#1 priority”“#3 option”),因为 Azure DevOps 会自动把 #<数字> 转成工作项链接,应改用“first”“third option”或改写句子。
语言方面,避免宣传或夸张措辞;不使用对比式表达,如“it's not just X, it's Y”“it's not just about...”“more than just...”“goes beyond...”,直接描述事物本身,不否定或贬低其他选项;使用主动语态和直接句式;避免通用套话,若一句话放到任何项目都成立,则没有提供有用信息;避免自问自答式修辞(如“The solution? Test everything that matters.”),应直接给出带项目具体背景的陈述。
图表方面,图表设计、评审、工具选择(Mermaid 与 Draw.io)及平台渲染规则,使用 diagram-design 技能。
文档结构方面,先写最重要的内容(结论、决策、摘要);使用一致的层级标题(H1 作标题,H2 作主要章节);在相关时包含元数据(Status、Date、Version)。
限制:资料未提供安装命令、配置方式、平台支持范围与收费信息。