tdesign-changelog
Skill4 starsChanged 5 months agoMITView on GitHub
当用户询问 TDesign 某组件能力在哪个版本新增、修复、废弃、Breaking Changes、迁移提示,或需要按版本、组件、关键词查询 changelog 时使用。只负责版本历史线索;不负责当前 API 形状、默认值或代码写法。
In this repository14 other files it gives its agents.
- skillsSkill
- tdesign-compositionSkill
- tdesign-design-specSkill
- tdesign-docsSkill
- tdesign-iconsSkill
- tdesign-miniprogramSkill
- tdesign-mobile-reactSkill
- tdesign-mobile-vueSkill
- tdesign-reactSkill
- tdesign-skillsSkill
- tdesign-uniappSkill
- tdesign-usage-guideSkill
- tdesign-vue2Skill
- tdesign-vue-nextSkill
The file
Files
TDesign 变更日志查询
本 skill 用于确认 TDesign 组件的版本变化,不替代当前技术栈 API。如果同目录存在 ../tdesign-skills/references/constraints.md,可参考它获取更详细的跨 skill 约束。
使用协议
- 必须通过
load_skill加载本 skill,不要绕过 skill 系统直接 grep、find 或 readreferences/下的内部文件。load_skill返回的 SKILL.md 包含查询命令和约束上下文,直接读文件会丢失这些关键指导,导致跳步、跨栈误判或凭记忆编造版本。 - 版本日志依赖
tdesign-mcp-server的get-component-changelog,不内置本地 changelog 快照,也不直接读取上游 changelog 原始数据。查询前先确认当前环境已安装并配置tdesign-mcp-server;若不可用,不要凭记忆编造版本,先明确告知用户缺少tdesign-mcp-server并引导其安装后再继续。 - 需要交接到其他 skill 时,对目标 skill 再次
load_skill,不要直接读目标 skill 的references/文件。 references/下的文件只在 SKILL.md 指引下按需读取,它们是 skill 的内部资料,不是独立文档。
适用问题
- 某个组件能力是哪个版本新增的。
- 某个属性、事件或行为在哪个版本修复了。
- 是否存在 Breaking Changes、废弃提示或迁移提醒。
- 指定版本区间内某组件经历了哪些变化。
- 只查询 Features、Bug Fixes、Breaking Changes 等类别。
查询方法
调用 tdesign-mcp-server 的 get-component-changelog,传 framework 与 names(组件数组,支持多组件批量),返回指定组件各版本变更日志;可选 version 表示只返回大于等于该版本的日志。
framework 与本仓库技术栈 skill 的映射:
| 技术栈 skill | mcp framework |
| tdesign-react | react |
| tdesign-vue-next | vue-next |
| tdesign-vue2 | vue |
| tdesign-mobile-react | mobile-react |
| tdesign-mobile-vue | mobile-vue |
| tdesign-miniprogram | miniprogram |
| tdesign-uniapp | uniapp |
调用示例:
get-component-changelog framework: "react", names: ["Button"]
get-component-changelog framework: "vue-next", names: ["Alert"], version: "1.14.0"
get-component-changelog framework: "mobile-vue", names: ["Form"]
get-component-changelog framework: "miniprogram", names: ["Upload"]
get-component-changelog framework: "uniapp", names: ["Upload"], version: "0.5.0"
get-component-changelog framework: "mobile-react", names: ["Dialog"]结果整理
get-component-changelog 返回的是组件各版本的完整变更日志,不会像曾经的本地脚本那样按 --version 精确匹配、--since/--until 区间、--category 类别或 --keyword 关键词帮你预过滤。它返回的每个版本条目含 version、date 与多个类别数组字段(如 breaking、feat、fix 等)。
因此拿到返回结果后,需按用户问题在结果内自行收敛:
- 指定版本:保留
version等于该版本的条目。 - 版本区间:保留
version落在[since, until]内的条目。 - 只看某类变更:只保留对应类别数组(如只看
breaking或feat)下的条目。 - 关键词过滤:在条目文本中按关键词匹配后再汇总。
更具体的查询示例与收敛步骤见 references/changelog-queries.md。
约束
- 查到版本线索后,仍要回到对应技术栈 skill,用
tdesign-mcp-server的get-component-docs确认真实写法,因为 changelog 只记录变更摘要,不含完整 API 形状。 - 不用 changelog 反推 API 形状、默认值或事件名,因为 changelog 描述可能省略上下文。
- 只判断版本变化,不替代
tdesign-docs的组件覆盖矩阵。 - 组件名查不到时,
get-component-changelog会在返回中标注不存在的组件,可据此向用户确认组件名是否正确或换名重试。 - 完整 collection 模式下,详细职责表、跨栈隔离细则和强制约束可参考
../tdesign-skills/references/constraints.md;未安装时按本文件内联规则执行。
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

