universal-dev-standards 6.14.0-beta.6 → 6.14.0-beta.8

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (99) hide show
  1. package/README.md +13 -3
  2. package/bin/uds.js +30 -6
  3. package/bundled/ai/options/code-review/pr-review.ai.yaml +20 -1
  4. package/bundled/ai/standards/code-review.ai.yaml +15 -2
  5. package/bundled/ai/standards/developer-memory.ai.yaml +12 -2
  6. package/bundled/ai/standards/full-coverage-testing.ai.yaml +44 -6
  7. package/bundled/ai/standards/open-work-tracking.ai.yaml +191 -11
  8. package/bundled/ai/standards/pipeline-security-gates.ai.yaml +48 -3
  9. package/bundled/ai/standards/project-context-memory.ai.yaml +12 -2
  10. package/bundled/core/code-review-checklist.md +20 -2
  11. package/bundled/core/developer-memory.md +12 -2
  12. package/bundled/core/full-coverage-testing.md +44 -4
  13. package/bundled/core/open-work-tracking.md +156 -16
  14. package/bundled/core/pipeline-security-gates.md +63 -0
  15. package/bundled/core/project-context-memory.md +10 -2
  16. package/bundled/locales/zh-CN/CHANGELOG.md +78 -3
  17. package/bundled/locales/zh-CN/README.md +1 -1
  18. package/bundled/locales/zh-CN/SECURITY.md +1 -1
  19. package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md +13 -4
  20. package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md +7 -1
  21. package/bundled/locales/zh-CN/adoption/checklists/enterprise.md +7 -1
  22. package/bundled/locales/zh-CN/adoption/checklists/minimal.md +13 -3
  23. package/bundled/locales/zh-CN/adoption/checklists/recommended.md +7 -1
  24. package/bundled/locales/zh-CN/core/code-review-checklist.md +17 -0
  25. package/bundled/locales/zh-CN/core/developer-memory.md +9 -0
  26. package/bundled/locales/zh-CN/core/full-coverage-testing.md +48 -8
  27. package/bundled/locales/zh-CN/core/pipeline-security-gates.md +64 -4
  28. package/bundled/locales/zh-CN/core/project-context-memory.md +5 -0
  29. package/bundled/locales/zh-CN/docs/AVAILABLE-STANDARDS.md +70 -0
  30. package/bundled/locales/zh-CN/docs/CHEATSHEET.md +4 -3
  31. package/bundled/locales/zh-CN/docs/CLI-INIT-OPTIONS.md +25 -23
  32. package/bundled/locales/zh-CN/docs/FEATURE-REFERENCE.md +13 -11
  33. package/bundled/locales/zh-CN/docs/USAGE-MODES-COMPARISON.md +6 -6
  34. package/bundled/locales/zh-CN/docs/WINDOWS-GUIDE.md +7 -1
  35. package/bundled/locales/zh-CN/docs/user/GETTING-STARTED.md +44 -0
  36. package/bundled/locales/zh-CN/options/code-review/pr-review.md +13 -2
  37. package/bundled/locales/zh-TW/CHANGELOG.md +78 -3
  38. package/bundled/locales/zh-TW/README.md +1 -1
  39. package/bundled/locales/zh-TW/SECURITY.md +1 -1
  40. package/bundled/locales/zh-TW/adoption/ADOPTION-GUIDE.md +13 -4
  41. package/bundled/locales/zh-TW/adoption/STATIC-DYNAMIC-GUIDE.md +7 -1
  42. package/bundled/locales/zh-TW/adoption/checklists/enterprise.md +7 -1
  43. package/bundled/locales/zh-TW/adoption/checklists/minimal.md +13 -3
  44. package/bundled/locales/zh-TW/adoption/checklists/recommended.md +7 -1
  45. package/bundled/locales/zh-TW/core/code-review-checklist.md +17 -0
  46. package/bundled/locales/zh-TW/core/developer-memory.md +9 -0
  47. package/bundled/locales/zh-TW/core/full-coverage-testing.md +48 -8
  48. package/bundled/locales/zh-TW/core/open-work-tracking.md +90 -14
  49. package/bundled/locales/zh-TW/core/pipeline-security-gates.md +64 -4
  50. package/bundled/locales/zh-TW/core/project-context-memory.md +5 -0
  51. package/bundled/locales/zh-TW/docs/AVAILABLE-STANDARDS.md +70 -0
  52. package/bundled/locales/zh-TW/docs/CHEATSHEET.md +4 -3
  53. package/bundled/locales/zh-TW/docs/CLI-INIT-OPTIONS.md +25 -23
  54. package/bundled/locales/zh-TW/docs/FEATURE-REFERENCE.md +13 -11
  55. package/bundled/locales/zh-TW/docs/USAGE-MODES-COMPARISON.md +6 -6
  56. package/bundled/locales/zh-TW/docs/WINDOWS-GUIDE.md +7 -1
  57. package/bundled/locales/zh-TW/docs/user/GETTING-STARTED.md +44 -0
  58. package/bundled/locales/zh-TW/options/code-review/pr-review.md +13 -2
  59. package/bundled/skills/SKILL_NAMING.md +9 -0
  60. package/bundled/templates/gates/check-anti-fake-tests.mjs +305 -5
  61. package/package.json +3 -1
  62. package/src/commands/audit.js +9 -2
  63. package/src/commands/check.js +17 -0
  64. package/src/commands/hitl.js +3 -0
  65. package/src/commands/init.js +41 -21
  66. package/src/commands/list.js +12 -3
  67. package/src/commands/mcp.js +2 -3
  68. package/src/commands/open-work.js +65 -6
  69. package/src/commands/quickstart.js +29 -13
  70. package/src/commands/release.js +41 -17
  71. package/src/commands/skills.js +19 -33
  72. package/src/commands/spec-split.js +28 -16
  73. package/src/commands/spec.js +34 -13
  74. package/src/commands/uninstall.js +2 -2
  75. package/src/commands/update.js +61 -61
  76. package/src/core/open-work-config.js +103 -0
  77. package/src/flows/init-flow.js +10 -0
  78. package/src/hitl/manager.js +4 -2
  79. package/src/i18n/messages.js +240 -63
  80. package/src/installers/skills-installer.js +3 -1
  81. package/src/mcp/__tests__/server.test.js +0 -1
  82. package/src/mcp/server.js +16 -4
  83. package/src/prompts/init.js +148 -13
  84. package/src/reconciler/index.js +42 -5
  85. package/src/uninstallers/skills-uninstaller.js +83 -16
  86. package/src/uninstallers/standards-uninstaller.js +56 -7
  87. package/src/utils/agents-installer.js +10 -17
  88. package/src/utils/available-standards-report.js +144 -0
  89. package/src/utils/available-standards.js +216 -0
  90. package/src/utils/copier.js +5 -4
  91. package/src/utils/friction-detector.js +27 -0
  92. package/src/utils/open-work-tracking.mjs +919 -48
  93. package/src/utils/prompt-closed.js +18 -0
  94. package/src/utils/skill-frontmatter.js +102 -0
  95. package/src/utils/skill-name-collision.js +169 -0
  96. package/src/utils/skills-install-paths.js +114 -0
  97. package/src/utils/skills-installer.js +63 -105
  98. package/src/utils/transient-fs.js +113 -0
  99. package/standards-registry.json +34 -9
@@ -22,6 +22,29 @@ export const messages = {
22
22
  disableHint: 'Set UDS_NO_UPDATE_CHECK=1 to disable'
23
23
  },
24
24
 
25
+ // XSPEC-458: standards UDS ships that this project does not have
26
+ availableStandards: {
27
+ title: 'Available upstream, not installed ({count})',
28
+ none: 'Available upstream, not installed: none. Every standard UDS installs by default is already in this project.',
29
+ categoryLine: '{category} ({count})',
30
+ installHint: 'Install one: uds update --apply --add-standard <id> (repeat the flag for several; add --plan to preview first)',
31
+ othersLine: 'Not listed above: {count} more standard(s) in categories `uds init` never installs ({breakdown}). Any of them can still be installed by id with --add-standard.',
32
+ applySummary: '{count} standard(s) UDS ships are not installed in this project (no file was changed for them).',
33
+ applyHint: 'See them: uds update --plan Install one: uds update --apply --add-standard <id>',
34
+ checkLine: '{count} upstream standard(s) not installed — run `uds update --plan` to see them',
35
+ checkNone: 'Upstream standards not installed: none',
36
+ addUnknown: 'Unknown standard id "{id}": it is not in the registry. Closest ids:',
37
+ addAlreadyInstalled: '"{id}" is already installed; nothing to add.',
38
+ addOtherMeans: '"{id}" is a {category} entry, not a standard file under .standards/; --add-standard does not install it (language, integration and template choices do).',
39
+ addNoSource: '"{id}" has no source file in this project\'s format ({format}), so it cannot be installed.',
40
+ addNothingDone: 'Nothing was changed. Run `uds update --plan` to see the rest of the plan.',
41
+ addNeedsMode: '--add-standard needs --plan or --apply. Example: uds update --apply --add-standard <id>',
42
+ addCannotCombine: '--add-standard cannot be combined with {flag}.',
43
+ reportHeldBack: 'Nothing to send: the "available standards" finding above is for you to act on, not feedback for the UDS maintainers.',
44
+ frictionStandard: '{count} available standard(s) not installed',
45
+ frictionSuggestion: 'Run `uds update --plan` to see them; install one with `uds update --apply --add-standard <id>`'
46
+ },
47
+
25
48
  // Sweep Command
26
49
  sweep: {
27
50
  title: 'Auto-Sweep: Code Cleanup',
@@ -365,7 +388,7 @@ export const messages = {
365
388
  installCount: 'Will install Skills to {count} location(s)',
366
389
  gitSharingHint: 'Tip: Commit .claude/skills/ to Git to share with your team',
367
390
  choices: {
368
- marketplace: 'Auto-updates, easy version management',
391
+ marketplace: 'Skills then come from the plugin and none are written to this project',
369
392
  userLevel: 'User Level',
370
393
  projectLevel: 'Project Level',
371
394
  user: 'Shared across all projects',
@@ -373,7 +396,7 @@ export const messages = {
373
396
  none: 'No Skills installation'
374
397
  },
375
398
  explanations: {
376
- marketplace: ' → Automatic updates when new versions are released\n → Easy install/uninstall via Claude Code Plugin system\n → Run: /plugin install universal-dev-standards@asia-ostrich',
399
+ marketplace: ' → Claude Code only, English skill texts only, stable releases only\n → Puts no files in the project\n → Run: /plugin install universal-dev-standards@asia-ostrich',
377
400
  user: ' → Skills available in all your projects',
378
401
  project: ' → Consider adding .claude/skills/ to .gitignore',
379
402
  none: ' → Full standards will be copied to .standards/'
@@ -385,7 +408,7 @@ export const messages = {
385
408
 
386
409
  // Marketplace Installation Guide
387
410
  marketplaceInstall: {
388
- claudeCodeTip: 'Claude Code can be installed via Marketplace:',
411
+ claudeCodeTip: 'Pre-selected below: install the skills into this project (the main path). Claude Code also has a plugin, an alternative with limits (Claude Code only, English skill texts only, stable releases only, no files in the project). To use the plugin, deselect everything below, then run:',
389
412
  guide: 'Please run the following command in Claude Code:',
390
413
  note: 'After installation, Skills will auto-load and stay updated.',
391
414
  alreadyInstalled: 'Marketplace plugin already installed.',
@@ -673,6 +696,11 @@ export const messages = {
673
696
  commands: {
674
697
  // Common messages used across commands
675
698
  common: {
699
+ localePackMissingTitle: 'The {locale} skill texts are not in this copy of UDS, so the skills were installed in English.',
700
+ localePackMissingLines: [
701
+ 'The Traditional and Simplified Chinese texts ship inside the UDS npm package (the locales/ folder), so this is not about your network: this copy of UDS is incomplete or damaged.',
702
+ 'To get the {locale} texts, reinstall UDS (npm install -g universal-dev-standards), then run: uds update --apply --skills --locale {localeLower}'
703
+ ],
676
704
  notInitialized: '✗ Standards not initialized in this project.',
677
705
  runInit: 'Run `uds init` to initialize.',
678
706
  couldNotReadManifest: '✗ Could not read manifest file.',
@@ -700,7 +728,7 @@ export const messages = {
700
728
  errorLevelRange: 'Error: Level must be 1, 2, or 3',
701
729
  showingLevel: 'Showing Level',
702
730
  errorUnknownCategory: 'Error: Unknown category',
703
- validCategories: 'Valid categories: skill, reference, extension, integration, template',
731
+ validCategories: 'Valid categories:',
704
732
  category: 'Category',
705
733
  appliesTo: 'Applies to',
706
734
  totalSummary: 'standards',
@@ -720,18 +748,33 @@ export const messages = {
720
748
  skills: {
721
749
  title: 'Universal Dev Standards - Installed Skills',
722
750
  noSkillsInstalled: 'No Universal Dev Standards skills installed.',
723
- installViaMarketplace: 'Install via Plugin Marketplace:',
724
- orManually: 'Or install manually:',
725
- recommended: '(recommended)',
726
751
  legacyMarketplaceWarning: '⚠ Legacy marketplace detected.',
727
752
  legacyMarketplaceHint: 'Consider upgrading to Plugin Marketplace for automatic updates.',
728
- manualInstallDeprecated: '⚠ Manual installation is deprecated.',
729
- manualInstallHint: 'Consider migrating to Plugin Marketplace.',
730
753
  totalUniqueSkills: 'Total unique skills',
731
754
  skillFilesTracked: '`uds check` tracks {files} skill files for these skills (it counts files across every tool, not skills).',
732
- recommendation: 'Recommendation: Migrate to Plugin Marketplace',
733
- benefits: 'Benefits: Automatic updates, better integration',
734
- migrateCommand: 'To migrate, run:'
755
+ // XSPEC-462 R1: the two ways to install, side by side, each with its limits.
756
+ installPaths: {
757
+ title: 'Two ways to install UDS skills',
758
+ projectTitle: 'Into the project (the main path)',
759
+ projectCommands: [
760
+ 'uds init --skills-location project (new project)',
761
+ 'uds update --apply --skills (project already set up)'
762
+ ],
763
+ projectPoints: [
764
+ 'Works with many AI tools: Claude Code, OpenCode, Cursor, Codex, Copilot, Windsurf and more.',
765
+ 'Has Traditional and Simplified Chinese skill texts (a missing one falls back to English with a warning).',
766
+ 'Follows the UDS version you installed, beta releases included.',
767
+ 'You update it yourself: run the same command again after upgrading UDS.'
768
+ ],
769
+ pluginTitle: 'Claude Code plugin marketplace (an alternative, with limits)',
770
+ pluginPoints: [
771
+ 'Claude Code only.',
772
+ 'English skill texts only: the plugin settings have no language choice.',
773
+ 'Follows stable releases only, so a beta of UDS gets no beta skills.',
774
+ 'Puts no files in the project, so `uds check` cannot compare them file by file.'
775
+ ],
776
+ bothNote: 'Installing both lists every skill twice in Claude Code (for example /commit and /universal-dev-standards:commit). Pick one; `uds check` warns when it finds both.'
777
+ }
735
778
  },
736
779
 
737
780
  // check command
@@ -818,11 +861,7 @@ export const messages = {
818
861
  skillsProject: 'Project',
819
862
  compatible: 'Compatible',
820
863
  openCodeNote: 'Note: OpenCode auto-detects .claude/skills/',
821
- considerMigrating: '⚠ Consider migrating to Plugin Marketplace',
822
- marketplaceAutoUpdates: 'Marketplace provides automatic updates and easier management.',
823
- toMigrate: 'To migrate:',
824
864
  skillsMarkedNotFound: '⚠ Skills marked as installed but not found',
825
- recommendedInstall: 'Recommended: Install via Plugin Marketplace',
826
865
  skillsNotInstalled: 'Skills not installed (using reference documents only)',
827
866
  // Coverage
828
867
  coverageSummary: 'Coverage Summary:',
@@ -874,6 +913,21 @@ export const messages = {
874
913
  projectCompliant: '✓ Project is compliant with standards',
875
914
  issuesDetected: '⚠ Some issues detected. Review above for details.',
876
915
  skillsIntegrityFix: ' Skill files listed above are missing or were changed: run `uds update --apply --skills` to reinstall them.',
916
+ // XSPEC-462 R2: project skills and the UDS plugin are both installed. Information only.
917
+ skillsTwiceTitle: '⚠ UDS skills are installed twice: {count} in this project (.claude/skills/) and the plugin {plugin}.',
918
+ skillsTwiceNames: 'Claude Code runs plugin skills as /<plugin>:<skill> and project skills as /<skill>, so each skill shows up twice (for example /commit and /universal-dev-standards:commit).',
919
+ skillsTwiceContext: 'Every skill\'s name and description is put into context on every turn, so the duplicate takes that space twice.',
920
+ skillsTwiceChoose: 'Keep one:',
921
+ skillsTwiceKeepProject: 'Keep the project copy: in Claude Code run /plugin uninstall {plugin}',
922
+ skillsTwiceKeepPlugin: 'Keep the plugin: delete the UDS skill folders under .claude/skills/ (`uds uninstall --skills-only` removes the skills and commands of every tool in this project).',
923
+ // XSPEC-465 R1: a personal skill has the same name as a UDS skill installed in the project. Information only.
924
+ skillNameCollisionTitle: '⚠ {count} UDS skill(s) installed in this project share a name with a personal skill, and Claude Code runs the personal one without any error:',
925
+ skillNameCollisionItem: '{command}: your {personal} replaces the UDS skill {uds}',
926
+ skillNameCollisionEffect: 'Personal skills rank above project skills, so the UDS skill is never run under that name.',
927
+ skillNameCollisionChoose: 'Pick one:',
928
+ skillNameCollisionRename: 'Keep both: rename your personal skill (its folder name, and `name:` in its SKILL.md).',
929
+ skillNameCollisionDrop: 'Keep yours only: delete the UDS skill folder under .claude/skills/ (`uds uninstall --skills-only` removes the skills and commands of every tool in this project).',
930
+ skillNameCollisionLimits: 'This check does not see skills your organization deploys at enterprise level (they rank above personal skills), or personal skills added after this run. No warning is not proof of no collision; `uds check` looks again every time.',
877
931
  commandsIntegrityFix: ' Command files listed above are missing or were changed: run `uds update --apply --commands` to reinstall them.',
878
932
  commandsStaleRecordsIgnored: ' {count} command record(s) ignored: they describe commands UDS does not ship.',
879
933
  commandsElsewhereIgnored: ' {count} command record(s) ignored: those commands are installed at user level, shared by every project, so this project\'s check does not vouch for them.',
@@ -983,6 +1037,13 @@ export const messages = {
983
1037
  integrations: 'Generated Configs',
984
1038
  skillsLabel: 'Skills',
985
1039
  skillsMarketplace: 'Plugin Marketplace (managed by Claude Code)',
1040
+ skillsFromPluginTitle: 'Skills: provided by the Claude Code plugin (no skill file was written to this project).',
1041
+ skillsSkippedTitle: 'Skills: none will be installed into this project.',
1042
+ skillsFromPluginLines: [
1043
+ 'Install the plugin in Claude Code: /plugin marketplace add AsiaOstrich/universal-dev-standards, then /plugin install universal-dev-standards@asia-ostrich',
1044
+ 'The plugin works in Claude Code only, loads English skill texts only, follows stable releases only, and puts no files in the project.',
1045
+ 'To put the skills into this project instead (many AI tools, Chinese texts): uds config --type skills --ai-tool claude-code --skills-location project --yes'
1046
+ ],
986
1047
  skillsInstallTo: 'install/update to {location}',
987
1048
  skillsUsingExisting: 'using existing ({location})',
988
1049
  skillsInstalledToCount: '{count} locations',
@@ -1091,10 +1152,8 @@ export const messages = {
1091
1152
  skillsLatest: 'Latest',
1092
1153
  updateViaMarketplace: 'Update via Plugin Marketplace:',
1093
1154
  autoUpdate: 'Auto-update: Restart Claude Code (updates on startup)',
1094
- manualUpdate: 'Manual: Run /plugin marketplace update anthropic-agent-skills',
1095
- manualInstallDeprecated: '⚠️ Manual installation is deprecated',
1096
- recommendedMigrate: 'Recommended: Migrate to Plugin Marketplace',
1097
- orUpdateManually: 'Or update manually:',
1155
+ manualUpdate: 'Manual: Run /plugin marketplace update asia-ostrich',
1156
+ skillsUpdateCommand: 'Update them with: uds update --apply --skills',
1098
1157
  // Integrations only
1099
1158
  updatingIntegrationsOnly: 'Updating integration files only...',
1100
1159
  noAiToolsConfigured: '⚠ No AI tools configured in manifest.',
@@ -1162,7 +1221,7 @@ export const messages = {
1162
1221
  commandsUpdatedCounts: 'Updated {commands} commands for {tools} AI tool(s): {locations}',
1163
1222
  commandsUpdatedWithErrors: 'Updated Commands with {errors} errors',
1164
1223
  // New standards detection
1165
- newStandardsFound: '{count} new standard(s) available for your level:',
1224
+ newStandardsFound: '{count} new standard(s) available (upstream has them, this project does not):',
1166
1225
  installNewStandards: 'Install these new standards?',
1167
1226
  installingNewStandards: 'Installing new standards...',
1168
1227
  newStandardsInstalled: 'Installed {count} new standard(s)',
@@ -1318,6 +1377,29 @@ export const messages = {
1318
1377
  disableHint: '設定 UDS_NO_UPDATE_CHECK=1 可關閉'
1319
1378
  },
1320
1379
 
1380
+ // XSPEC-458:UDS 有出貨、這個專案沒有的標準
1381
+ availableStandards: {
1382
+ title: '上游有、專案沒裝({count} 個)',
1383
+ none: '上游有、專案沒裝:沒有。UDS 預設安裝的標準,這個專案都已經有了。',
1384
+ categoryLine: '{category}({count})',
1385
+ installHint: '要裝其中一個:uds update --apply --add-standard <id>(可重複旗標裝多個;先加 --plan 預覽)',
1386
+ othersLine: '上面沒列出的另有 {count} 個標準,屬於 `uds init` 從不安裝的類別({breakdown});它們仍可用 --add-standard 指名安裝。',
1387
+ applySummary: '上游有 {count} 個標準沒裝在這個專案(沒有為它們改動任何檔案)。',
1388
+ applyHint: '查看:uds update --plan 安裝其中一個:uds update --apply --add-standard <id>',
1389
+ checkLine: '上游有 {count} 個標準未安裝 — 執行 `uds update --plan` 查看',
1390
+ checkNone: '上游有、專案沒裝的標準:沒有',
1391
+ addUnknown: '未知的標準 id「{id}」:不在登記表裡。最相近的 id:',
1392
+ addAlreadyInstalled: '「{id}」已安裝,不需要再加。',
1393
+ addOtherMeans: '「{id}」屬於 {category} 類,不是 .standards/ 裡的標準檔,--add-standard 不安裝它(它由語言、整合、範本的選項安裝)。',
1394
+ addNoSource: '「{id}」在這個專案的格式({format})下沒有來源檔,無法安裝。',
1395
+ addNothingDone: '沒有改動任何東西。執行 `uds update --plan` 看計畫的其餘部分。',
1396
+ addNeedsMode: '--add-standard 要搭配 --plan 或 --apply。例:uds update --apply --add-standard <id>',
1397
+ addCannotCombine: '--add-standard 不能與 {flag} 同時使用。',
1398
+ reportHeldBack: '沒有要送出的內容:上面「可用標準未安裝」那一項是給你自己處理的,不是給 UDS 維護者的回饋。',
1399
+ frictionStandard: '{count} 個可用標準未安裝',
1400
+ frictionSuggestion: '執行 `uds update --plan` 查看;用 `uds update --apply --add-standard <id>` 安裝其中一個'
1401
+ },
1402
+
1321
1403
  // Sweep Command
1322
1404
  sweep: {
1323
1405
  title: '自動清理:程式碼整理',
@@ -1661,7 +1743,7 @@ export const messages = {
1661
1743
  installCount: '將安裝 Skills 到 {count} 個位置',
1662
1744
  gitSharingHint: '提示:將 .claude/skills/ 加入版控,即可與團隊共享',
1663
1745
  choices: {
1664
- marketplace: '自動更新、輕鬆管理版本',
1746
+ marketplace: '技能改由外掛提供,這個專案不會寫入任何技能檔',
1665
1747
  userLevel: '使用者層級',
1666
1748
  projectLevel: '專案層級',
1667
1749
  user: '跨專案共享',
@@ -1669,7 +1751,7 @@ export const messages = {
1669
1751
  none: '不安裝 Skills'
1670
1752
  },
1671
1753
  explanations: {
1672
- marketplace: ' → 新版本發布時自動更新\n → 透過 Claude Code 外掛系統輕鬆安裝/移除\n → 執行: /plugin install universal-dev-standards@asia-ostrich',
1754
+ marketplace: ' → 只支援 Claude Code、只有英文技能文字、只跟正式版\n → 專案內不放檔案\n → 執行: /plugin install universal-dev-standards@asia-ostrich',
1673
1755
  user: ' → Skills 可在所有專案中使用',
1674
1756
  project: ' → 建議將 .claude/skills/ 加入 .gitignore',
1675
1757
  none: ' → 完整標準將複製到 .standards/'
@@ -1681,7 +1763,7 @@ export const messages = {
1681
1763
 
1682
1764
  // Marketplace Installation Guide
1683
1765
  marketplaceInstall: {
1684
- claudeCodeTip: 'Claude Code 可透過 Marketplace 安裝:',
1766
+ claudeCodeTip: '下方已預先勾選:把技能裝進這個專案(主要路徑)。Claude Code 另有外掛,是有限制的替代方式(只支援 Claude Code、只有英文技能文字、只跟正式版、專案內不放檔案)。要用外掛,請取消下方所有勾選,再執行:',
1685
1767
  guide: '請在 Claude Code 中執行以下指令:',
1686
1768
  note: '安裝完成後,Skills 將自動載入並保持更新。',
1687
1769
  alreadyInstalled: 'Marketplace 外掛已安裝。',
@@ -1969,6 +2051,11 @@ export const messages = {
1969
2051
  commands: {
1970
2052
  // Common messages used across commands
1971
2053
  common: {
2054
+ localePackMissingTitle: '這份 UDS 裡沒有 {locale} 的技能文字,所以技能裝的是英文版。',
2055
+ localePackMissingLines: [
2056
+ '繁體與簡體中文文字都放在 UDS 的 npm 套件內(locales/ 資料夾),所以這不是網路問題:這份 UDS 不完整或已損毀。',
2057
+ '要取得 {locale} 文字,請重新安裝 UDS(npm install -g universal-dev-standards),再執行:uds update --apply --skills --locale {localeLower}'
2058
+ ],
1972
2059
  notInitialized: '✗ 此專案尚未初始化標準。',
1973
2060
  runInit: '執行 `uds init` 進行初始化。',
1974
2061
  couldNotReadManifest: '✗ 無法讀取 manifest 檔案。',
@@ -1996,7 +2083,7 @@ export const messages = {
1996
2083
  errorLevelRange: '錯誤:等級必須是 1、2 或 3',
1997
2084
  showingLevel: '顯示等級',
1998
2085
  errorUnknownCategory: '錯誤:未知類別',
1999
- validCategories: '有效類別:skill, reference, extension, integration, template',
2086
+ validCategories: '有效類別:',
2000
2087
  category: '類別',
2001
2088
  appliesTo: '適用於',
2002
2089
  totalSummary: '項標準',
@@ -2016,18 +2103,33 @@ export const messages = {
2016
2103
  skills: {
2017
2104
  title: '通用開發標準 - 已安裝的 Skills',
2018
2105
  noSkillsInstalled: '未安裝任何通用開發標準 Skills。',
2019
- installViaMarketplace: '透過 Plugin Marketplace 安裝:',
2020
- orManually: '或手動安裝:',
2021
- recommended: '(推薦)',
2022
2106
  legacyMarketplaceWarning: '⚠ 偵測到舊版 marketplace。',
2023
2107
  legacyMarketplaceHint: '建議升級到 Plugin Marketplace 以獲得自動更新。',
2024
- manualInstallDeprecated: '⚠ 手動安裝已棄用。',
2025
- manualInstallHint: '建議遷移到 Plugin Marketplace。',
2026
2108
  totalUniqueSkills: '唯一 Skills 總數',
2027
2109
  skillFilesTracked: '`uds check` 追蹤這些技能的 {files} 個技能檔案(它計的是所有工具的檔案數,不是技能數)。',
2028
- recommendation: '建議:遷移到 Plugin Marketplace',
2029
- benefits: '好處:自動更新、更好的整合',
2030
- migrateCommand: '遷移指令:'
2110
+ // XSPEC-462 R1:兩種裝法並列,各自寫明限制。
2111
+ installPaths: {
2112
+ title: '安裝 UDS 技能的兩種方式',
2113
+ projectTitle: '裝進專案(主要路徑)',
2114
+ projectCommands: [
2115
+ 'uds init --skills-location project (新專案)',
2116
+ 'uds update --apply --skills (已設定過的專案)'
2117
+ ],
2118
+ projectPoints: [
2119
+ '支援多種 AI 工具:Claude Code、OpenCode、Cursor、Codex、Copilot、Windsurf 等。',
2120
+ '有繁體中文與簡體中文的技能文字(缺的會警告並退回英文)。',
2121
+ '跟著你裝的 UDS 版本走,包含測試版。',
2122
+ '由你自己更新:升級 UDS 後再跑一次同一個指令。'
2123
+ ],
2124
+ pluginTitle: 'Claude Code 外掛市集(替代方式,有限制)',
2125
+ pluginPoints: [
2126
+ '只支援 Claude Code。',
2127
+ '只有英文技能文字:外掛設定沒有語系選擇。',
2128
+ '只跟正式版:UDS 的測試版不會有測試版技能。',
2129
+ '專案內不放檔案,所以 `uds check` 無法逐檔比對。'
2130
+ ],
2131
+ bothNote: '兩種都裝,Claude Code 會把每個技能列出兩次(例如 /commit 與 /universal-dev-standards:commit)。請擇一;`uds check` 發現兩者並存時會警告。'
2132
+ }
2031
2133
  },
2032
2134
 
2033
2135
  // check command
@@ -2114,11 +2216,7 @@ export const messages = {
2114
2216
  skillsProject: '專案',
2115
2217
  compatible: '相容',
2116
2218
  openCodeNote: '注意:OpenCode 自動偵測 .claude/skills/',
2117
- considerMigrating: '⚠ 建議遷移到 Plugin Marketplace',
2118
- marketplaceAutoUpdates: 'Marketplace 提供自動更新和更簡易的管理。',
2119
- toMigrate: '遷移步驟:',
2120
2219
  skillsMarkedNotFound: '⚠ Skills 標記為已安裝但找不到',
2121
- recommendedInstall: '建議:透過 Plugin Marketplace 安裝',
2122
2220
  skillsNotInstalled: 'Skills 未安裝(僅使用參考文件)',
2123
2221
  // Coverage
2124
2222
  coverageSummary: '覆蓋率摘要:',
@@ -2170,6 +2268,21 @@ export const messages = {
2170
2268
  projectCompliant: '✓ 專案符合標準',
2171
2269
  issuesDetected: '⚠ 偵測到一些問題。請檢視上方詳情。',
2172
2270
  skillsIntegrityFix: ' 上方列出的技能檔遺失或被改過:執行 `uds update --apply --skills` 重新安裝。',
2271
+ // XSPEC-462 R2:專案層與 UDS 外掛都裝了。純資訊。
2272
+ skillsTwiceTitle: '⚠ UDS 技能裝了兩次:本專案(.claude/skills/)有 {count} 個,外掛 {plugin} 也已安裝。',
2273
+ skillsTwiceNames: 'Claude Code 執行外掛技能是 /<外掛名>:<技能名>,執行專案技能是 /<技能名>,所以每個技能會出現兩次(例如 /commit 與 /universal-dev-standards:commit)。',
2274
+ skillsTwiceContext: '每個技能的名稱與描述每回合都會放進脈絡,重複裝等於重複占用。',
2275
+ skillsTwiceChoose: '二擇一:',
2276
+ skillsTwiceKeepProject: '留專案這份:在 Claude Code 執行 /plugin uninstall {plugin}',
2277
+ skillsTwiceKeepPlugin: '留外掛:刪掉 .claude/skills/ 底下的 UDS 技能資料夾(`uds uninstall --skills-only` 會移除本專案所有工具的技能與命令)。',
2278
+ // XSPEC-465 R1:個人層技能與專案裡裝的 UDS 技能同名。純資訊。
2279
+ skillNameCollisionTitle: '⚠ 本專案裝的 UDS 技能有 {count} 個與個人技能同名,Claude Code 會執行你的個人技能,而且不會報任何錯:',
2280
+ skillNameCollisionItem: '{command}:你的 {personal} 蓋掉了 UDS 技能 {uds}',
2281
+ skillNameCollisionEffect: '個人層的優先序高於專案層,所以這個名稱下 UDS 技能永遠不會被執行。',
2282
+ skillNameCollisionChoose: '二擇一:',
2283
+ skillNameCollisionRename: '兩個都留:把你的個人技能改名(資料夾名稱,以及 SKILL.md 裡的 `name:`)。',
2284
+ skillNameCollisionDrop: '只留你的:刪掉 .claude/skills/ 底下那個 UDS 技能資料夾(`uds uninstall --skills-only` 會移除本專案所有工具的技能與命令)。',
2285
+ skillNameCollisionLimits: '這項檢查看不到組織以企業層下發的技能(優先序高於個人層),也看不到這次執行之後才新增的個人技能。沒有警告不等於沒有撞名;`uds check` 每次都會重查。',
2173
2286
  commandsIntegrityFix: ' 上方列出的斜線命令檔遺失或被改過:執行 `uds update --apply --commands` 重新安裝。',
2174
2287
  commandsStaleRecordsIgnored: ' 已忽略 {count} 筆命令紀錄:它們描述的是 UDS 不出貨的命令。',
2175
2288
  commandsElsewhereIgnored: ' 已忽略 {count} 筆命令紀錄:這些命令裝在使用者層級(所有專案共用),本專案的檢查不為它們背書。',
@@ -2277,6 +2390,13 @@ export const messages = {
2277
2390
  integrations: '整合配置檔',
2278
2391
  skillsLabel: 'Skills',
2279
2392
  skillsMarketplace: 'Plugin Marketplace(由 Claude Code 管理)',
2393
+ skillsFromPluginTitle: '技能:由 Claude Code 外掛提供(這個專案沒有寫入任何技能檔)。',
2394
+ skillsSkippedTitle: '技能:不會把任何技能裝進這個專案。',
2395
+ skillsFromPluginLines: [
2396
+ '在 Claude Code 安裝外掛:/plugin marketplace add AsiaOstrich/universal-dev-standards,再執行 /plugin install universal-dev-standards@asia-ostrich',
2397
+ '外掛只支援 Claude Code,只載入英文技能文字,只跟正式版,專案內不放檔案。',
2398
+ '想改成把技能裝進這個專案(多種 AI 工具、有中文文字):uds config --type skills --ai-tool claude-code --skills-location project --yes'
2399
+ ],
2280
2400
  skillsInstallTo: '安裝/更新到 {location}',
2281
2401
  skillsUsingExisting: '使用現有({location})',
2282
2402
  skillsInstalledToCount: '已安裝到 {count} 個位置',
@@ -2382,10 +2502,8 @@ export const messages = {
2382
2502
  skillsLatest: '最新',
2383
2503
  updateViaMarketplace: '透過 Plugin Marketplace 更新:',
2384
2504
  autoUpdate: '自動更新:重新啟動 Claude Code(啟動時更新)',
2385
- manualUpdate: '手動:執行 /plugin marketplace update anthropic-agent-skills',
2386
- manualInstallDeprecated: '⚠️ 手動安裝已棄用',
2387
- recommendedMigrate: '建議:遷移到 Plugin Marketplace',
2388
- orUpdateManually: '或手動更新:',
2505
+ manualUpdate: '手動:執行 /plugin marketplace update asia-ostrich',
2506
+ skillsUpdateCommand: '更新方式:uds update --apply --skills',
2389
2507
  // Integrations only
2390
2508
  updatingIntegrationsOnly: '僅更新整合檔案中...',
2391
2509
  noAiToolsConfigured: '⚠ manifest 中未設定任何 AI 工具。',
@@ -2451,7 +2569,7 @@ export const messages = {
2451
2569
  commandsUpdatedCounts: '已為 {tools} 個 AI 工具更新 {commands} 個斜線命令:{locations}',
2452
2570
  commandsUpdatedWithErrors: '更新斜線命令時發生 {errors} 個錯誤',
2453
2571
  // New standards detection
2454
- newStandardsFound: '有 {count} 個新標準可供您的等級使用:',
2572
+ newStandardsFound: '有 {count} 個新標準可用(上游有、這個專案沒有):',
2455
2573
  installNewStandards: '是否安裝這些新標準?',
2456
2574
  installingNewStandards: '安裝新標準中...',
2457
2575
  newStandardsInstalled: '已安裝 {count} 個新標準',
@@ -2607,6 +2725,29 @@ export const messages = {
2607
2725
  disableHint: '设置 UDS_NO_UPDATE_CHECK=1 可关闭'
2608
2726
  },
2609
2727
 
2728
+ // XSPEC-458:UDS 有发布、这个项目没有的标准
2729
+ availableStandards: {
2730
+ title: '上游有、项目没装({count} 个)',
2731
+ none: '上游有、项目没装:没有。UDS 默认安装的标准,这个项目都已经有了。',
2732
+ categoryLine: '{category}({count})',
2733
+ installHint: '要装其中一个:uds update --apply --add-standard <id>(可重复该选项装多个;先加 --plan 预览)',
2734
+ othersLine: '上面没列出的另有 {count} 个标准,属于 `uds init` 从不安装的类别({breakdown});它们仍可用 --add-standard 指名安装。',
2735
+ applySummary: '上游有 {count} 个标准没装在这个项目(没有为它们改动任何文件)。',
2736
+ applyHint: '查看:uds update --plan 安装其中一个:uds update --apply --add-standard <id>',
2737
+ checkLine: '上游有 {count} 个标准未安装 — 执行 `uds update --plan` 查看',
2738
+ checkNone: '上游有、项目没装的标准:没有',
2739
+ addUnknown: '未知的标准 id“{id}”:不在登记表里。最相近的 id:',
2740
+ addAlreadyInstalled: '“{id}”已安装,不需要再加。',
2741
+ addOtherMeans: '“{id}”属于 {category} 类,不是 .standards/ 里的标准文件,--add-standard 不安装它(它由语言、集成、模板的选项安装)。',
2742
+ addNoSource: '“{id}”在这个项目的格式({format})下没有来源文件,无法安装。',
2743
+ addNothingDone: '没有改动任何东西。执行 `uds update --plan` 查看计划的其余部分。',
2744
+ addNeedsMode: '--add-standard 要搭配 --plan 或 --apply。例:uds update --apply --add-standard <id>',
2745
+ addCannotCombine: '--add-standard 不能与 {flag} 同时使用。',
2746
+ reportHeldBack: '没有要发送的内容:上面“可用标准未安装”那一项是给你自己处理的,不是给 UDS 维护者的反馈。',
2747
+ frictionStandard: '{count} 个可用标准未安装',
2748
+ frictionSuggestion: '执行 `uds update --plan` 查看;用 `uds update --apply --add-standard <id>` 安装其中一个'
2749
+ },
2750
+
2610
2751
  // Sweep Command
2611
2752
  sweep: {
2612
2753
  title: '自动清理:代码整理',
@@ -2950,7 +3091,7 @@ export const messages = {
2950
3091
  installCount: '将安装 Skills 到 {count} 个位置',
2951
3092
  gitSharingHint: '提示:将 .claude/skills/ 加入版本控制,即可与团队共享',
2952
3093
  choices: {
2953
- marketplace: '自动更新、轻松管理版本',
3094
+ marketplace: '技能改由插件提供,这个项目不会写入任何技能文件',
2954
3095
  userLevel: '用户层级',
2955
3096
  projectLevel: '项目层级',
2956
3097
  user: '跨项目共享',
@@ -2958,7 +3099,7 @@ export const messages = {
2958
3099
  none: '不安装 Skills'
2959
3100
  },
2960
3101
  explanations: {
2961
- marketplace: ' → 新版本发布时自动更新\n → 通过 Claude Code 插件系统轻松安装/移除\n → 执行: /plugin install universal-dev-standards@asia-ostrich',
3102
+ marketplace: ' → 只支持 Claude Code、只有英文技能文本、只跟正式版\n → 项目内不放文件\n → 执行: /plugin install universal-dev-standards@asia-ostrich',
2962
3103
  user: ' → Skills 可在所有项目中使用',
2963
3104
  project: ' → 建议将 .claude/skills/ 加入 .gitignore',
2964
3105
  none: ' → 完整标准将复制到 .standards/'
@@ -2970,7 +3111,7 @@ export const messages = {
2970
3111
 
2971
3112
  // Marketplace Installation Guide
2972
3113
  marketplaceInstall: {
2973
- claudeCodeTip: 'Claude Code 可通过 Marketplace 安装:',
3114
+ claudeCodeTip: '下方已预先勾选:把技能装进这个项目(主要路径)。Claude Code 另有插件,是有限制的替代方式(只支持 Claude Code、只有英文技能文本、只跟正式版、项目内不放文件)。要用插件,请取消下方所有勾选,再执行:',
2974
3115
  guide: '请在 Claude Code 中执行以下指令:',
2975
3116
  note: '安装完成后,Skills 将自动加载并保持更新。',
2976
3117
  alreadyInstalled: 'Marketplace 插件已安装。',
@@ -3187,6 +3328,11 @@ export const messages = {
3187
3328
  commands: {
3188
3329
  // Common messages used across commands
3189
3330
  common: {
3331
+ localePackMissingTitle: '这份 UDS 里没有 {locale} 的技能文本,所以技能装的是英文版。',
3332
+ localePackMissingLines: [
3333
+ '繁体与简体中文文本都放在 UDS 的 npm 包内(locales/ 文件夹),所以这不是网络问题:这份 UDS 不完整或已损坏。',
3334
+ '要获取 {locale} 文本,请重新安装 UDS(npm install -g universal-dev-standards),再执行:uds update --apply --skills --locale {localeLower}'
3335
+ ],
3190
3336
  notInitialized: '✗ 此项目尚未初始化标准。',
3191
3337
  runInit: '执行 `uds init` 进行初始化。',
3192
3338
  couldNotReadManifest: '✗ 无法读取 manifest 文件。',
@@ -3214,7 +3360,7 @@ export const messages = {
3214
3360
  errorLevelRange: '错误:等级必须是 1、2 或 3',
3215
3361
  showingLevel: '显示等级',
3216
3362
  errorUnknownCategory: '错误:未知类别',
3217
- validCategories: '有效类别:skill, reference, extension, integration, template',
3363
+ validCategories: '有效类别:',
3218
3364
  category: '类别',
3219
3365
  appliesTo: '适用于',
3220
3366
  totalSummary: '项标准',
@@ -3262,6 +3408,13 @@ export const messages = {
3262
3408
  integrations: '集成配置文件',
3263
3409
  skillsLabel: 'Skills',
3264
3410
  skillsMarketplace: 'Plugin Marketplace(由 Claude Code 管理)',
3411
+ skillsFromPluginTitle: '技能:由 Claude Code 插件提供(这个项目没有写入任何技能文件)。',
3412
+ skillsSkippedTitle: '技能:不会把任何技能装进这个项目。',
3413
+ skillsFromPluginLines: [
3414
+ '在 Claude Code 安装插件:/plugin marketplace add AsiaOstrich/universal-dev-standards,再执行 /plugin install universal-dev-standards@asia-ostrich',
3415
+ '插件只支持 Claude Code,只加载英文技能文本,只跟正式版,项目内不放文件。',
3416
+ '想改成把技能装进这个项目(多种 AI 工具、有中文文本):uds config --type skills --ai-tool claude-code --skills-location project --yes'
3417
+ ],
3265
3418
  skillsInstallTo: '安装/更新到 {location}',
3266
3419
  skillsUsingExisting: '使用现有({location})',
3267
3420
  skillsInstalledToCount: '已安装到 {count} 个位置',
@@ -3321,18 +3474,33 @@ export const messages = {
3321
3474
  skills: {
3322
3475
  title: '通用开发标准 - 已安装的 Skills',
3323
3476
  noSkillsInstalled: '未安装任何通用开发标准 Skills。',
3324
- installViaMarketplace: '通过 Plugin Marketplace 安装:',
3325
- orManually: '或手动安装:',
3326
- recommended: '(推荐)',
3327
3477
  legacyMarketplaceWarning: '⚠ 检测到旧版 marketplace。',
3328
3478
  legacyMarketplaceHint: '建议升级到 Plugin Marketplace 获得自动更新。',
3329
- manualInstallDeprecated: '⚠ 手动安装已弃用。',
3330
- manualInstallHint: '建议迁移到 Plugin Marketplace。',
3331
3479
  totalUniqueSkills: '唯一 Skills 总数',
3332
3480
  skillFilesTracked: '`uds check` 跟踪这些技能的 {files} 个技能文件(它计的是所有工具的文件数,不是技能数)。',
3333
- recommendation: '建议:迁移到 Plugin Marketplace',
3334
- benefits: '好处:自动更新、更好的集成',
3335
- migrateCommand: '迁移指令:'
3481
+ // XSPEC-462 R1:两种装法并列,各自写明限制。
3482
+ installPaths: {
3483
+ title: '安装 UDS 技能的两种方式',
3484
+ projectTitle: '装进项目(主要路径)',
3485
+ projectCommands: [
3486
+ 'uds init --skills-location project (新项目)',
3487
+ 'uds update --apply --skills (已设置过的项目)'
3488
+ ],
3489
+ projectPoints: [
3490
+ '支持多种 AI 工具:Claude Code、OpenCode、Cursor、Codex、Copilot、Windsurf 等。',
3491
+ '有繁体中文与简体中文的技能文本(缺失的会警告并退回英文)。',
3492
+ '跟随你安装的 UDS 版本,包含测试版。',
3493
+ '由你自己更新:升级 UDS 后再运行一次同一个指令。'
3494
+ ],
3495
+ pluginTitle: 'Claude Code 插件市场(替代方式,有限制)',
3496
+ pluginPoints: [
3497
+ '只支持 Claude Code。',
3498
+ '只有英文技能文本:插件设置没有语言选项。',
3499
+ '只跟正式版:UDS 的测试版不会有测试版技能。',
3500
+ '项目内不放文件,所以 `uds check` 无法逐文件比对。'
3501
+ ],
3502
+ bothNote: '两种都装,Claude Code 会把每个技能列出两次(例如 /commit 与 /universal-dev-standards:commit)。请择一;`uds check` 发现两者并存时会警告。'
3503
+ }
3336
3504
  },
3337
3505
 
3338
3506
  // check command
@@ -3419,11 +3587,7 @@ export const messages = {
3419
3587
  skillsProject: '项目',
3420
3588
  compatible: '兼容',
3421
3589
  openCodeNote: '注意:OpenCode 自动检测 .claude/skills/',
3422
- considerMigrating: '⚠ 考虑迁移到 Plugin Marketplace',
3423
- marketplaceAutoUpdates: 'Marketplace 提供自动更新和更简便的管理。',
3424
- toMigrate: '要迁移:',
3425
3590
  skillsMarkedNotFound: '⚠ Skills 标记为已安装但未找到',
3426
- recommendedInstall: '建议:通过 Plugin Marketplace 安装',
3427
3591
  skillsNotInstalled: 'Skills 未安装(仅使用参考文档)',
3428
3592
  // Coverage
3429
3593
  coverageSummary: '覆盖率摘要:',
@@ -3475,6 +3639,21 @@ export const messages = {
3475
3639
  projectCompliant: '✓ 项目符合标准',
3476
3640
  issuesDetected: '⚠ 检测到一些问题。详情请查看上文。',
3477
3641
  skillsIntegrityFix: ' 上方列出的技能文件缺失或被改过:运行 `uds update --apply --skills` 重新安装。',
3642
+ // XSPEC-462 R2:项目层与 UDS 插件都装了。纯信息。
3643
+ skillsTwiceTitle: '⚠ UDS 技能装了两次:本项目(.claude/skills/)有 {count} 个,插件 {plugin} 也已安装。',
3644
+ skillsTwiceNames: 'Claude Code 执行插件技能是 /<插件名>:<技能名>,执行项目技能是 /<技能名>,所以每个技能会出现两次(例如 /commit 与 /universal-dev-standards:commit)。',
3645
+ skillsTwiceContext: '每个技能的名称与描述每回合都会放进上下文,重复装等于重复占用。',
3646
+ skillsTwiceChoose: '二选一:',
3647
+ skillsTwiceKeepProject: '留项目这份:在 Claude Code 执行 /plugin uninstall {plugin}',
3648
+ skillsTwiceKeepPlugin: '留插件:删掉 .claude/skills/ 下的 UDS 技能文件夹(`uds uninstall --skills-only` 会移除本项目所有工具的技能与命令)。',
3649
+ // XSPEC-465 R1:个人层技能与项目里装的 UDS 技能同名。纯信息。
3650
+ skillNameCollisionTitle: '⚠ 本项目装的 UDS 技能有 {count} 个与个人技能同名,Claude Code 会执行你的个人技能,而且不会报任何错:',
3651
+ skillNameCollisionItem: '{command}:你的 {personal} 盖掉了 UDS 技能 {uds}',
3652
+ skillNameCollisionEffect: '个人层的优先级高于项目层,所以这个名称下 UDS 技能永远不会被执行。',
3653
+ skillNameCollisionChoose: '二选一:',
3654
+ skillNameCollisionRename: '两个都留:把你的个人技能改名(文件夹名称,以及 SKILL.md 里的 `name:`)。',
3655
+ skillNameCollisionDrop: '只留你的:删掉 .claude/skills/ 下那个 UDS 技能文件夹(`uds uninstall --skills-only` 会移除本项目所有工具的技能与命令)。',
3656
+ skillNameCollisionLimits: '这项检查看不到组织以企业层下发的技能(优先级高于个人层),也看不到这次运行之后才新增的个人技能。没有警告不等于没有撞名;`uds check` 每次都会重查。',
3478
3657
  commandsIntegrityFix: ' 上方列出的斜杠命令文件缺失或被改过:运行 `uds update --apply --commands` 重新安装。',
3479
3658
  commandsStaleRecordsIgnored: ' 已忽略 {count} 条命令记录:它们描述的是 UDS 不发布的命令。',
3480
3659
  commandsElsewhereIgnored: ' 已忽略 {count} 条命令记录:这些命令装在用户级(所有项目共用),本项目的检查不为它们背书。',
@@ -3595,10 +3774,8 @@ export const messages = {
3595
3774
  skillsLatest: '最新',
3596
3775
  updateViaMarketplace: '通过 Plugin Marketplace 更新:',
3597
3776
  autoUpdate: '自动更新:重启 Claude Code(启动时更新)',
3598
- manualUpdate: '手动:运行 /plugin marketplace update anthropic-agent-skills',
3599
- manualInstallDeprecated: '⚠️ 手动安装已弃用',
3600
- recommendedMigrate: '建议:迁移到 Plugin Marketplace',
3601
- orUpdateManually: '或手动更新:',
3777
+ manualUpdate: '手动:运行 /plugin marketplace update asia-ostrich',
3778
+ skillsUpdateCommand: '更新方式:uds update --apply --skills',
3602
3779
  // Integrations only
3603
3780
  updatingIntegrationsOnly: '仅更新集成文件...',
3604
3781
  noAiToolsConfigured: '⚠ manifest 中未配置 AI 工具。',
@@ -3664,7 +3841,7 @@ export const messages = {
3664
3841
  commandsUpdatedCounts: '已为 {tools} 个 AI 工具更新 {commands} 个斜线命令:{locations}',
3665
3842
  commandsUpdatedWithErrors: '更新斜线命令时发生 {errors} 个错误',
3666
3843
  // New standards detection
3667
- newStandardsFound: '有 {count} 个新标准可用于您的级别:',
3844
+ newStandardsFound: '有 {count} 个新标准可用(上游有、这个项目没有):',
3668
3845
  installNewStandards: '是否安装这些新标准?',
3669
3846
  installingNewStandards: '正在安装新标准...',
3670
3847
  newStandardsInstalled: '已安装 {count} 个新标准',
@@ -164,7 +164,9 @@ export async function installSkills(skillsConfig, projectPath, messages, results
164
164
  // P1-CLI-1: Emit a single locale-fallback WARN after the install loop when
165
165
  // adopters requested a localized variant but some skills only ship in English.
166
166
  // The aggregated list is built in installSkillsToMultipleAgents (deduped).
167
- if (Array.isArray(installResult.localeFallbacks) && installResult.localeFallbacks.length > 0) {
167
+ // (When the whole pack is missing, `installSkillsToMultipleAgents` already said so once; listing all 56
168
+ // names as well would bury that message.)
169
+ if (!installResult.localePackMissing && Array.isArray(installResult.localeFallbacks) && installResult.localeFallbacks.length > 0) {
168
170
  // `messages` is a flat command-scope bundle (e.g. t().commands.init);
169
171
  // the WARN helper looks for localeFallbackTitle/Hint keys directly on it.
170
172
  printLocaleFallbackWarning(installResult.localeFallbacks, skillsConfig.locale, messages);
@@ -64,7 +64,6 @@ meta:
64
64
  // ---------------------------------------------------------------------------
65
65
  function makeServer() {
66
66
  return new McpServer({
67
- udsRoot: '/fake/project',
68
67
  udsRepoRoot: '/fake/uds-repo',
69
68
  });
70
69
  }
package/src/mcp/server.js CHANGED
@@ -10,8 +10,21 @@ import { fileURLToPath } from 'url';
10
10
 
11
11
  const __dirname = dirname(fileURLToPath(import.meta.url));
12
12
 
13
- // UDS standards root (relative to this file: cli/src/mcp/server.js → repo root is ../../../../)
14
- const UDS_REPO_ROOT = resolve(__dirname, '../../../../');
13
+ /**
14
+ * Where the files UDS ships (ai/standards/, templates/) are.
15
+ *
16
+ * This file is `<cli>/src/mcp/server.js`, so `<cli>` is two levels up. A published package carries the shipped
17
+ * files in `<cli>/bundled/`; a repository checkout carries them one level above `<cli>`. (It used to climb four
18
+ * levels, which lands outside the repository and, in an installed package, outside the package: every tool that
19
+ * reads a shipped file failed with ENOENT, and the unit tests never saw it because they replace the file system.)
20
+ *
21
+ * @returns {string}
22
+ */
23
+ export function resolveUdsRepoRoot() {
24
+ const cliRoot = resolve(__dirname, '../..');
25
+ const bundled = join(cliRoot, 'bundled');
26
+ return existsSync(join(bundled, 'ai')) ? bundled : resolve(cliRoot, '..');
27
+ }
15
28
 
16
29
  /**
17
30
  * Required DESIGN.md sections per frontend-design-standards.
@@ -29,9 +42,8 @@ const REQUIRED_DESIGN_SECTIONS = [
29
42
 
30
43
  export class McpServer {
31
44
  constructor(options = {}) {
32
- this.udsRoot = options.udsRoot || process.cwd();
33
45
  // For reading UDS bundled files, always use UDS_REPO_ROOT
34
- this.udsRepoRoot = options.udsRepoRoot || UDS_REPO_ROOT;
46
+ this.udsRepoRoot = options.udsRepoRoot || resolveUdsRepoRoot();
35
47
  }
36
48
 
37
49
  /**