用途:这是 Dify 文档仓库中面向用户指南页面的规则包,本身不是入口,需在 dify-docs-write 下运行,其规则与流程实现该技能针对用户指南页面的各阶段。
主要能力:一是范围规则,将每个目标页面匹配到对应读者画像;use-dify 页面存在 cloud 与 self-host 两份产品副本,无共享页面、无跨受众导航,两处都存在的页面需同时处理,共享内容改进同批落地,受众专属块(套餐限制、环境变量提示、企业版提示)各自保留;release/<version> 分支只改 self-host 副本,仍覆盖三种语言,不改 cloud 副本。二是环境变量发现,在 Dify 代码库运行 grep -rn "<FEATURE_KEYWORD>" docker/.env.example docker/envs/ api/configs/,用变量中可能出现的功能名尝试 2–3 个关键词变体;无匹配则跳过环境变量指引,有匹配则记录每个变量为必需或可选及默认值,并在 S4 范围报告中排队 dify-docs-env-vars 流程,同会话更新 en/self-host/deploy/configuration/environments.mdx。
写作规则:按页面路径对应的读者画像写作;页面不重述自身受众,self-host 页读者即自托管用户,cloud 页读者即 Dify Cloud 用户,限定语只在受众中立的目录树(en/learn/、en/api-reference/、en/cli/、en/develop-plugin/)中用于消歧;命名不同产品与比较优势声明属于例外。若发现相关环境变量,按用户指南中的环境变量规范呈现。
读者画像:en/cloud/use-dify/ 为 Dify Cloud 应用构建者,开发者与非技术用户混合,假设具备基础 AI 认知、无基础设施或深入编码知识,优先任务完成与结果;en/self-host/use-dify/ 为团队自托管 Dify 的应用构建者,可提及环境变量但读者是构建者而非运维;en/self-host/deploy/ 为 DevOps 工程师与系统管理员,假设具备 Docker、数据库、网络、环境变量等强基础设施知识,优先精确技术细节;en/develop-plugin/ 为构建自定义 Dify 插件的开发者,假设具备强 Python 技能与 Dify 核心概念,优先 API 契约、扩展点、代码模式。
环境变量呈现:self-host 副本在提示框中列出必需变量及取值并链接参考,默认值、机制、交互与失败模式由 environments.mdx 负责;cloud 副本绝不出现环境变量内容,仅对套餐限制功能使用套餐门控模式。提示框类型:变量必需时用 <Note>,仅自定义已有行为时用 <Info>。用户指南中排除默认值、变量原因、部署机制与变量交互。仅当变量在参考中有独立标题锚点(#var_name)时才链接变量名,表格行变量保持纯代码。
限制:资料未提供该规则包的具体安装方式、收费信息与适用平台。