Agent Skills
› zeabur-oss/zeabur
› zeabur-wording
zeabur-wording
GitHub规范 Zeabur 产品界面、API 及文档的多语言文案编写,涵盖术语使用、i18n 键值管理及错误提示标准,确保用户可见文本的一致性与专业性。
Trigger Scenarios
修改用户可见的界面字符串
重写或重命名文案
审查多语言翻译内容
Install
npx skills add zeabur-oss/zeabur --skill zeabur-wording -g -y
SKILL.md
Frontmatter
{
"name": "zeabur-wording",
"description": "Zeabur's own terms and steps for any text people read in Zeabur — interface strings in web\/src\/i18n (en, zh-TW, zh-CN), API problem messages, sign-in pages, zeaburctl output, README and docs. Use whenever a change adds, renames or rewrites a user-visible string, or when reviewing copy."
}
Wording
Follow zeabur-writing (skills-lock.json pins it) for how text reads in English, zh-TW and
zh-CN. This skill adds Zeabur's terms and conventions; docs/internal/wording.md is the
rulebook, and its term beats anything in zeabur-writing.
- Name the thing by its plain term first; the Kubernetes term follows as secondary text only
where a professional needs it (
docs/internal/wording.md, "Terms"). Never invent a term; use the glossary's (通行密鑰、機密變數、磁碟、磁碟區、用量、概覽…). web/src/i18n/en.tsdefines the keys; zh-TW and zh-CN are typed against it. Start in whichever locale you think in, write each one so it reads on its own, and change all three in the same pull request. Usecommon.coloninstead of a literal colon.- Empty states and absences say what is missing and what to do, never a bare 「沒有。」/
"None." A section that has nothing is usually hidden or says why and offers the action.
Section titles name their content (公開網域、私有網路), not their position (「在這裡設定」).
Show the real value with a copy button (
api.shop.svc.cluster.local:8080), not a description of it. Kubernetes terms go in the design system'sTermtag, never a made-up middle word (內部位址). - Errors keep the raw cause available (details, copy) but out of the headline.
- Check, inside
nix develop:
plus thevale <changed files> (cd web && bun run typecheck && bun run test) nix develop .#zh -c ./scripts/check-zh-tw.shzeabur-writingchecks. Then read the strings on the rendered page in all three locales at desktop and narrow widths (zeabur-uifor the demo server).
Moving a hard-coded string into the catalogues is part of the change, not a follow-up.
Version History
- e6ff195 Current 2026-11-02 08:51


