Discourse功能开关
在 Discourse 源码里新增一个 upcoming change 功能开关,配好站点设置、翻译、预览图和代码读取方式。
功能与用途
给 Discourse 加一个需要灰度放量的新功能时,光写业务代码不够,还要补站点设置、翻译文案、管理页预览图和前后端的开关读取逻辑,漏一项就会出错。这个技能按固定清单走完这套流程:先问清状态、影响类型、受众和配图,再改 site_settings.yml 与 server.en.yml,用脚本把图片压到限定体积,最后给出 Ruby 和 JavaScript 两边的读取写法。需要你已经在 Discourse 源码仓库里干活。
适用场景
- 给 Discourse 写了个新功能要灰度放量,需要把它变成:给 Discourse 写了个新功能要灰度放量,需要把它变成带 alpha/beta 状态的 upcoming change
- 插件里也想挂 upcoming change,但不确定设置在:插件里也想挂 upcoming change,但不确定设置在插件目录该怎么写、图片又该放哪
- 提交了改动被 stylelint 规则 discourse/:提交了改动被 stylelint 规则 discourse/uc-classes-in-where 拦下,需要弄清 uc- 类名的正确作用域写法
适用人群
- Discourse 插件开发者
- Discourse 核心贡献者
- 自建 Discourse 论坛的技术负责人
使用步骤
- 先提供功能开关名称,并回答状态、影响类型、受众和是否需要配图这几个问题,缺的它会追问
- 它在 config/site_settings.yml 里用 Grep 定位现有 upcoming_change: 样例,然后在合适位置插入新的 site setting 配置块
- 在 config/locales/server.en.yml 的 site_settings 下补上英文说明文案,让管理页能显示这个开关的用途
- 把预览图拷到 public/images/upcoming_changes/<setting_name>.png,再跑优化脚本转格式、缩宽到 1200px 并压缩
- 在 Ruby 里用 user.upcoming_change_enabled? 或在 JavaScript 里读 this.siteSettings 来按开关控制行为,插件项目按插件对应路径落盘
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 专业
- 版本
- main
- 最近更新
- 2026-09-13
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Use when adding a new upcoming change feature flag to Discourse - handles site settings, translations, images, and code access patterns
使用前准备
- 需要在 Discourse 源码仓库中操作,能跑 bin/rails runner 执行图片优化脚本,并了解 YAML 配置与 Rails/前端 siteSettings 读取方式
依赖与权限
- 读取用户主动提供的内容