💡 Background and Solution
💡 Background and Solution
The Select dropdown could jump when the option list changed during search. This PR keeps the scroll position stable after options are updated. No public API changes are introduced.
对应中文示例:
```markdown
### 💡 需求背景和解决方案
Select 在搜索过程中更新选项后,下拉列表会出现滚动位置跳动。这个 PR 在选项变更后保持滚动位置稳定。不涉及公开 API 变更。
两个示例的共同结构是:“现象 + 处理方式 + 对外影响声明”三段式,先写要解决的问题,再写采用的方案,最后点明外部可感知差异(有或没有)。正文不是逐文件流水账,而应归纳“为什么改”和“改完后对开发者/用户有什么影响”。
五、Change Log 的写法:实质条目与占位条目
模板中的 Change Log 是一张双语表格。参考文档将其区分为两类场景。
1. 需要写实质 changelog 的场景
当改动会影响以下任一对象时,必须写明对用户的影响:
- 组件使用方式;
- 公开 API;
- 交互行为;
- UI / 视觉表现;
- 用户实际可感知结果。
示例写法:
### 📝 Change Log
| Language | Changelog |
| ---------- | ------------------------------------------------ |
| 🇺🇸 English | Fix Select dropdown scroll jumping during search |
| 🇨🇳 Chinese | 修复 Select 搜索时下拉列表滚动位置跳动问题 |
写作视角是“对开发者的影响”,而非实现细节。最终这些条目会进入仓库根目录的 CHANGELOG.en-US.md 与 CHANGELOG.zh-CN.md,可以对照仓库现有 changelog 的条目风格(每条附 PR 编号与组件名)来校准自己的措辞粒度。
2. 无需 changelog 的场景
常见包括:
sitedocsdemoci- 纯测试
- 内部维护或重构,且无外部可感知变化
这类场景不要硬写影响描述,可直接使用占位表格:
### 📝 Change Log
| Language | Changelog |
| ---------- | --------------------- |
| 🇺🇸 English | No changelog required |
| 🇨🇳 Chinese | 无需更新日志 |
也可以更短,直接写 N/A、No changelog required、无需更新日志 之一。前提是 保留模板 section,不要直接删掉整个 changelog 区块——模板结构中该 section 必须存在。这一占位策略与 CI 行为完全对齐:pr-open-check.yml 中 skip-title-start: 'docs, chore, test, ci' 的配置意味着这些类型的 PR 会跳过 changelog 填写检查,因此占位即可通过校验。
六、基线分支(base branch)的推断建议
参考文档的核心目标:尽量推断“当前分支实际从哪里切出来”,而不是拍脑袋默认 master。建议的判断顺序为:
- 用户明确指定了
base branch-> 直接使用; - 查看当前分支是否能从
reflog看出 checkout 来源; - 查看
git branch -vv的 tracking / upstream 作为辅助线索; - 必要时结合
merge-base比较候选分支; - 若仍无法确定,再退回远端默认分支或仓库默认分支。
配套命令:
git branch --show-current
git branch -vv
git reflog show --date=local $(git branch --show-current)
git remote show origin
git merge-base HEAD <candidate-branch>
同时给出三条注意事项:
- upstream 不是绝对父分支,只是候选线索;
reflog最接近真实答案,但不一定一直存在(可能被清理);- 不确定时要明确告诉用户“这是推断值”。
在 SKILL.md 中该流程还有两个配套约定:不要默认就用 master;若改动性质判断为 feat 且当前基线不是明显的功能分支(如 feature/*),应额外提醒用户确认是否应提交到对应 feature 分支——这与 中文模板 头部注释“新特性请提交至 feature 分支,其余可提交至 master 分支”的要求相呼应。此外,创建 PR 前还应基于 base...HEAD 的完整 diff 归纳改动(git log --oneline <base>..HEAD、git diff --stat <base>...HEAD),而不是只根据最近一个 commit 或工作区未提交内容写 PR。
七、创建 PR 前的确认草稿
参考文档要求:在真正执行 gh pr create 之前,先给用户一个确认版草稿,例如:
我先整理了一版待提交的 PR 草稿,请你确认:
- Base branch: `feature-x`
- PR title: `site: adjust token panel interaction on theme preview page`
- PR type: `📝 Site / documentation improvement`
- Change Log: `No changelog required`
如果没问题,我再继续创建 PR;如果你想改 title、type、base 或正文,我先帮你改。
atomcodeClaude Code 的开源替代方案。连接任意大模型,编辑代码,运行命令,自动验证 — 全自动执行。用 Rust 构建,极致性能。 | An open-source alternative to Claude Code. Connect any LLM, edit code, run commands, and verify changes — autonomously. Built in Rust for speed. Get StartedRust0623
Hy4-previewHy4 preview 是由腾讯混元团队研发的新一代混合专家(MoE)旗舰模型。模型总参数量 770B,每个 token 激活 49B,主干共包含78层,第一层采用标准 FFN,其余 77 层均为 MoE 结构,每层包含 256 个路由专家与 1 个共享专家,每个 token 激活 top-8 路由专家及共享专家。主干之外原生内置 1 层 MTP(总参数量 10B,激活 0.7B)以支持投机解码。Python00
GLM-5.3GLM-5.3 与 GLM-5.2 使用相同的基座模型——所有提升均来自后训练。与 GLM-5.2 相比,它在复杂编程和长程任务上的表现显著提升。Jinja00
GLM-5.3-FlashGLM-5.3-Flash (320B-A18B),是GLM-5系列的首个原生多模态模型。320B总参数,能力超过GLM-5.2Jinja00
Spark-X2.5-4BSpark-X2.5-4B 旨在让强大的 AI 更实用、更高效、更易获得。在广泛日常任务中表现强劲,涵盖对话、写作、翻译、推理、编码、工具调用以及智能体工作流,并在同等规模的开源模型中取得领先成绩。Spark-X2.5 将面向效率的架构与最高 1M tokens 的原生上下文窗口相结合,并支持 200 多种语言。Python00
Spark-X2.5-1.7BSpark-X2.5-1.7B 旨在让强大的 AI 更加实用、高效且易于获取。这些模型在广泛的日常任务中表现出色,涵盖对话、写作、翻译、推理、编程、工具调用和智能体工作流,并在同等规模的开源模型中取得领先结果。Spark-X2.5 将面向效率的架构与最高 1M tokens 的原生上下文窗口相结合,并支持 200 多种语言。Python00