القائمة
Editing extension i18n message files and their consumers. Use when editing packages/*/src/messages/i18n.ts, adding/changing nls.localize strings, or choosing placeholder tokens (%s/%d/...).
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
Enforces Effect-TS patterns for services, errors, layers, and atoms. Use when writing code with Effect.Service, Schema.TaggedError, Layer composition, or effect-atom React components.
Consume the salesforcedx-vscode-services extension API. Use when an extension depends on salesforcedx-vscode-services and you are registering commands, calling its services (Workspace, Connection, Project, Settings, FS, Channel, Media, prompts), watching files/config/target-org, or wiring the AllServicesLayer/runtime in extensionProvider.ts.
package.json conventions for this repo. Use when editing/reviewing a package.json — name, types, browser, files, dependencies, devDependencies, packaging, scripts, or vscode contributes.
Prefer vscode-uri over node:path. Use when .ts files in /src import node:path or use path.join/basename/dirname/resolve, URI.file, or memfs paths.
Add custom SVG icons to salesforcedx-vscode-services for font generation. Use when adding new icons to media/icons-src, creating SVG icons for VS Code extension, or defining font-based icons.
TypeScript coding standards — apply when writing, reviewing, or refactoring .ts/.tsx, or naming/renaming .ts files (camelCase casing).
| name | i18n-messages |
| description | Editing extension i18n message files and their consumers. Use when editing packages/*/src/messages/i18n.ts, adding/changing nls.localize strings, or choosing placeholder tokens (%s/%d/...). |
Scope:
packages/*/src/messages/i18n.ts + code consuming those messages via nls.localizepackage.json/package.nls.json nls strings (command titles etc.)nls.localize(key, ...args) substitutes via node:util.format — packages/salesforcedx-vscode-i18n/src/i18n/message.ts:50 (return format(possibleLabel, ...labelArgs)).
| Token | Use | Behavior (node:util.format) |
|---|---|---|
%s | string | string |
%d | count/number | number as-is (3.7→3.7, no truncation) |
%i | integer | truncates float (3.7→3) |
%f | float | float |
%j | value | JSON |
%o %O | value | inspected object |
%c | — | CSS directive, no output |
%% | literal % | % only when args present; bare string skips format() (message.ts:37 args.length > 0 guard) and keeps %% |
%n | NONE | unsupported — renders literal %n, NOT substituted |
Default: counts → %d, strings → %s. (Origin: Removed %n orgs shipped literal %n.)
message.ts:39 counts specifiers with /%[sdifj%]/g (%% excluded, L40). On mismatch it logs and trims extra args (L41-48); missing args are NOT filled — trailing unmatched tokens render literally.
%o %O %c substitute at runtime but are NOT in that regex → they escape arg-count validation. Avoid relying on them; prefer %s/%d/%j.%n is not counted and not a real token → expected-count is off by what you intended and the %n prints literally.grep package.nls.json for an existing equivalent before adding — reuse, don't duplicate.
From salesforcedx-vscode-org (src/messages/i18n.ts, package.nls.json):
| Surface | Example | Cap | Punctuation |
|---|---|---|---|
Command title (package.nls.json *_text) | SFDX: Create a Default Scratch Org... | Title Case, SFDX: prefix | none (... ok for further input) |
| QuickPick/InputBox placeholder | i18n.ts:72 Select scratch orgs and sandboxes to delete | sentence | none |
| Confirm prompt | i18n.ts:73 Permanently delete %d org(s)? This cannot be undone. | sentence | terminal ./? |
Notification (show*Message) | i18n.ts:100 ... orgs expire in the next %d days. ... | sentence | terminal . |
| Button/action label | i18n.ts:74,75 Delete, Logout | Title Case | none |
| Tree/status-bar label+tooltip | i18n.ts:103 Open Default Org in Browser | Title Case | none |
| Log/channel line | — | sentence | . |
| Validation error | — | sentence | terminal . |
Don't prefix new strings with Error:/Warning: — the show*Message API supplies severity. i18n.ts:100 (Warning: One or more...) is a legacy anti-pattern; don't copy it, and don't edit it (out of scope). See vscode-window-messages.
vscode-window-messages covers the notification/button API (which show*Message, return values, Effect, modal). This skill is the message text. Don't duplicate API guidance here.