universal-dev-standards 5.10.0 → 5.12.1

package/bundled/locales/zh-CN/skills/adr-assistant/SKILL.md

@@ -38,3 +38,46 @@ CAPTURE ──► ANALYZE ──► DECIDE ──► RECORD ──► LINK
 
 - 核心规范：[adr-standards.md](../../../../core/adr-standards.md)
 - 详细指南：[guide.md](./guide.md)
+
+
+## Next Steps Guidance | 下一步引導
+
+After `/adr` completes, the AI assistant should suggest:
+
+> **ADR created. Suggested next steps:**
+> - Execute `/sdd` to create a spec if the decision requires implementation
+> - Execute `/commit` to commit the ADR file
+> - Update related SPECs to reference this ADR
+> - Share with team for review if status is `Proposed`
+
+> **ADR 已建立。建議下一步：**
+> - 執行 `/sdd` 建立規格（若決策需要實作）
+> - 執行 `/commit` 提交 ADR 檔案
+> - 更新相關規格以引用此 ADR
+> - 若狀態為 `Proposed`，分享給團隊審查
+
+## AI Agent Behavior | AI 代理行為
+
+When the user invokes `/adr`, the AI assistant MUST:
+
+1. **Check existing ADRs** — Search `docs/adr/` to determine next ADR number
+2. **Guide interactively** — Ask about context, drivers, and options step by step
+3. **Generate the file** — Write ADR to `docs/adr/ADR-NNN-title.md`
+4. **Suggest links** — Identify related SPECs or ADRs to cross-reference
+5. **Offer next steps** — Show the Next Steps Guidance above
+
+When the user invokes `/adr list`:
+1. Scan `docs/adr/` directory
+2. Parse status from each ADR file
+3. Display as a table: Number, Title, Status, Date
+
+When the user invokes `/adr supersede [ADR-NNN]`:
+1. Read the existing ADR
+2. Guide creation of a new ADR
+3. Update old ADR status to `Superseded by ADR-NNN`
+4. Add `Supersedes ADR-NNN` to new ADR
+
+## Reference | 參考
+
+- Core Standard: [adr-standards.md](../../core/adr-standards.md)
+- Detailed Guide: [guide.md](./guide.md)

package/bundled/locales/zh-CN/skills/ai-collaboration-standards/SKILL.md

@@ -173,3 +173,38 @@ This project uses **English** certainty tags.
 此技能依据 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 釋出。
 
 **來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
+
+
+## Next Steps Guidance | 下一步引導
+
+After `/ai-collaboration` completes, the AI assistant should suggest:
+
+> **AI 協作行為規範已掌握。建議下一步 / AI collaboration behavior standards understood. Suggested next steps:**
+> - 執行 `/ai-instructions` 建立或更新 CLAUDE.md 等 AI 指令檔案 ⭐ **Recommended / 推薦** — 將協作標準寫入專案配置 / Write collaboration standards into project configuration
+> - 執行 `/ai-friendly-architecture` 設計 AI 友善架構 — 從長期架構層面優化 AI 協作 / Optimize AI collaboration at the architecture level
+> - 執行 `/review` 運用確定性標籤進行程式碼審查 — 實踐基於證據的分析 / Practice evidence-based analysis
+
+---
+
+## Related Standards
+
+- [Anti-Hallucination Standards](../../core/anti-hallucination.md)
+- [Code Review Checklist](../../core/code-review-checklist.md)
+- [Testing Standards](../../core/testing-standards.md)
+
+---
+
+## Version History
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.1.0 | 2026-01-25 | Added: Unified Tag System with Certainty and Derivation tag categories |
+| 1.0.0 | 2025-12-24 | Added: Standard sections (Purpose, Related Standards, Version History, License) |
+
+---
+
+## License
+
+This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
+
+**Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

package/bundled/locales/zh-CN/skills/ai-friendly-architecture/SKILL.md

@@ -219,3 +219,38 @@ documentation:
 本技能以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权发布。
 
 **来源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
+
+
+## Next Steps Guidance | 下一步引導
+
+After `/ai-friendly-architecture` completes, the AI assistant should suggest:
+
+> **AI 友善架構指南已掌握。建議下一步 / AI-friendly architecture guide understood. Suggested next steps:**
+> - 執行 `/sdd` 將 AI 友善架構設計納入正式規格 ⭐ **Recommended / 推薦** — 確保架構決策有規格追蹤 / Ensure architecture decisions are tracked in specs
+> - 建立 `.ai-context.yaml` 和 `QUICK-REF.md` — 立即實作 AI 友善結構 / Implement AI-friendly structure immediately
+> - 執行 `/ai-instructions` 更新 CLAUDE.md 以反映架構配置 — 讓 AI 指令檔案與架構保持同步 / Keep AI instruction files in sync with architecture
+
+---
+
+## Related Standards
+
+- [AI-Friendly Architecture](../../core/ai-friendly-architecture.md) - Core architecture standard
+- [Project Structure](../../core/project-structure.md) - Directory organization
+- [Documentation Structure](../../core/documentation-structure.md) - Documentation layering
+- [Anti-Hallucination](../../core/anti-hallucination.md) - AI accuracy standards
+
+---
+
+## Version History
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.0.0 | 2026-01-25 | Initial release |
+
+---
+
+## License
+
+This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
+
+**Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

package/bundled/locales/zh-CN/skills/ai-instruction-standards/SKILL.md

@@ -212,3 +212,38 @@ project/
 本技能以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权发布。
 
 **来源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
+
+
+## Next Steps Guidance
+
+After `/ai-instructions` completes, suggest:
+
+> - Create or update project's `CLAUDE.md` / `AGENTS.md` ⭐ **Recommended** — Apply standards immediately
+> - Run `/ai-friendly-architecture` to optimize AI collaboration at the architecture level
+> - Run `/ai-collaboration` to review AI behavior guidelines
+
+---
+
+## Related Standards
+
+- [AI Instruction File Standards](../../core/ai-instruction-standards.md) - Core standard
+- [Documentation Writing Standards](../../core/documentation-writing-standards.md) - Writing guidelines
+- [Anti-Hallucination Guidelines](../../core/anti-hallucination.md) - AI accuracy rules
+- [AI-Friendly Architecture](../../core/ai-friendly-architecture.md) - Context optimization
+
+---
+
+## Version History
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 2.0.0 | 2026-04-28 | Add Gemini CLI, OpenAI Codex CLI; update Cursor (MDC format, deprecated .cursorrules); update OpenCode (AGENTS.md primary); update Copilot (multiple file types); update Windsurf (Workflows); add AGENTS.md cross-tool standard section |
+| 1.0.0 | 2026-01-25 | Initial release |
+
+---
+
+## License
+
+This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
+
+**Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

package/bundled/locales/zh-CN/skills/contract-test-assistant/SKILL.md

@@ -29,3 +29,27 @@ description: |
 
 - 详细指南：[contract-testing.md](../../../../options/testing/contract-testing.md)
 - 技能指南：[guide.md](./guide.md)
+
+
+## Next Steps Guidance | 下一步引導
+
+After `/contract-test` completes:
+
+> **合約測試引導完成。建議下一步：**
+> - 執行 `/ci-cd` 將合約驗證加入 CI 管線
+> - 執行 `/api-design` 完善 API 設計
+> - 執行 `/testing` 整合到整體測試策略
+
+## Reference | 參考
+
+- Detailed guide: [contract-testing.md](../../options/testing/contract-testing.md)
+- Related: [api-design-assistant](../api-design-assistant/SKILL.md)
+
+## AI Agent Behavior | AI 代理行為
+
+When `/contract-test` is invoked:
+1. **Assess** — Ask about architecture (monolith, microservices, number of APIs)
+2. **Recommend** — Suggest strategy based on architecture
+3. **Guide** — Walk through setup for chosen strategy
+4. **Generate** — Create example contract test files
+5. **Verify** — If `verify` subcommand, scan for contracts and report coverage

package/bundled/locales/zh-CN/skills/documentation-guide/SKILL.md

@@ -418,3 +418,40 @@ MIT
 本 Skill 以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权發布。
 
 **來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
+
+
+## Next Steps Guidance | 下一步引導
+
+After `/docs-guide` completes, the AI assistant should suggest:
+
+> **文件結構與需求已釐清。建議下一步 / Documentation structure and requirements clarified. Suggested next steps:**
+> - 執行 `/docs` 根據指南直接產生專案文件 ⭐ **Recommended / 推薦** — 立即將文件指南化為行動 / Turn documentation guidelines into action immediately
+> - 執行 `/changelog` 建立或更新 CHANGELOG.md — 確保變更歷史完整 / Ensure change history is complete
+> - 執行 `/sdd` 將文件需求納入規格驅動開發 — 確保文件與功能同步 / Ensure docs stay in sync with features
+
+---
+
+## Related Standards
+
+- [Documentation Writing Standards](../../core/documentation-writing-standards.md) - Content requirements
+- [Documentation Structure](../../core/documentation-structure.md) - File organization
+- [Changelog Standards](../../core/changelog-standards.md) - CHANGELOG format
+- [Changelog Guide Skill](../changelog-guide/SKILL.md) - CHANGELOG skill
+
+---
+
+## Version History
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 2.1.0 | 2026-03-17 | Added: Diátaxis classification, LLM discovery, quality metrics, enhanced ADR template, translation-friendly writing |
+| 2.0.0 | 2026-01-12 | Added: Project type matrix, document templates, documentation pyramid |
+| 1.0.0 | 2025-12-24 | Initial release |
+
+---
+
+## License
+
+This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
+
+**Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

package/bundled/locales/zh-CN/skills/error-code-guide/SKILL.md

@@ -267,3 +267,36 @@ export const ErrorCodes = {
 此技能採用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权。
 
 **來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
+
+
+## Next Steps Guidance | 下一步引導
+
+After `/errors` completes, the AI assistant should suggest:
+
+> **錯誤碼設計已完成。建議下一步 / Error code design completed. Suggested next steps:**
+> - 執行 `/sdd` 將錯誤碼設計納入正式規格 ⭐ **Recommended / 推薦** — 確保錯誤碼在規格中有完整定義 / Ensure error codes are fully defined in specs
+> - 執行 `/logging` 設定結構化日誌以配合錯誤碼 — 讓錯誤碼與日誌系統整合 / Integrate error codes with logging system
+> - 執行 `/tdd` 為錯誤處理邏輯撰寫測試 — 確保每個錯誤碼都有對應的測試 / Ensure each error code has corresponding tests
+
+---
+
+## Related Standards
+
+- [Error Code Standards](../../core/error-code-standards.md)
+- [Logging Standards](../../core/logging-standards.md)
+
+---
+
+## Version History
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.0.0 | 2025-12-30 | Initial release |
+
+---
+
+## License
+
+This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
+
+**Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

package/bundled/locales/zh-CN/skills/git-workflow-guide/SKILL.md

@@ -216,3 +216,37 @@ git push origin feature/my-feature
 本技能採用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权發布。
 
 **來源**：[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
+
+
+## Next Steps Guidance | 下一步引導
+
+After `/git-flow` completes, the AI assistant should suggest:
+
+> **Git 工作流程已設定。建議下一步 / Git workflow configured. Suggested next steps:**
+> - 執行 `git checkout -b feature/<描述>` 建立功能分支開始開發 ⭐ **Recommended / 推薦** — 立即套用所選的分支策略 / Apply the chosen branching strategy immediately
+> - 執行 `/commit` 學習提交訊息規範 — 確保提交訊息格式一致 / Ensure consistent commit message format
+> - 執行 `/checkin` 了解簽入品質門檻 — 在提交前確保程式碼品質 / Ensure code quality before commits
+
+---
+
+## Related Standards
+
+- [Git Workflow](../../core/git-workflow.md) - Core Git workflow standard
+- [Commit Message Guide](../../core/commit-message-guide.md) - Commit message conventions
+- [Checkin Standards](../../core/checkin-standards.md) - Pre-commit quality gates
+
+---
+
+## Version History
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.0.0 | 2025-12-24 | Added: Standard sections (Purpose, Related Standards, Version History, License) |
+
+---
+
+## License
+
+This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
+
+**Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

package/bundled/locales/zh-CN/skills/logging-guide/SKILL.md

@@ -283,3 +283,36 @@ logger.error('处理订单失败', {
 此技能採用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权。
 
 **來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
+
+
+## Next Steps Guidance | 下一步引導
+
+After `/logging` completes, the AI assistant should suggest:
+
+> **日誌標準已掌握。建議下一步 / Logging standards understood. Suggested next steps:**
+> - 根據日誌指南在程式碼中實作結構化日誌 ⭐ **Recommended / 推薦** — 立即將日誌標準應用到專案 / Apply logging standards to the project immediately
+> - 執行 `/errors` 設計錯誤碼以配合日誌系統 — 讓錯誤追蹤更有效率 / Make error tracking more efficient
+> - 執行 `/sdd` 將可觀測性需求納入規格 — 確保日誌需求在規格中有定義 / Ensure logging requirements are defined in specs
+
+---
+
+## Related Standards
+
+- [Logging Standards](../../core/logging-standards.md)
+- [Error Code Standards](../../core/error-code-standards.md)
+
+---
+
+## Version History
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.0.0 | 2025-12-30 | Initial release |
+
+---
+
+## License
+
+This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
+
+**Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

package/bundled/locales/zh-CN/skills/project-structure-guide/SKILL.md

@@ -149,3 +149,22 @@ project/
 - [核心：文档结构](../../core/documentation-structure.md)
 - [指南：文件归档决策指南](../../core/guides/file-placement-guide.md)
 - [AI：项目结构选项](../../../../options/project-structure/)
+
+
+## Next Steps Guidance | 下一步引導
+
+After `/project-structure` completes, the AI assistant should suggest:
+
+> **專案結構已建立或審查完成。建議下一步 / Project structure created or reviewed. Suggested next steps:**
+> - 執行 `/sdd` 開始規格驅動開發，將專案結構納入正式規格 ⭐ **Recommended / 推薦** — 確保結構決策有規格追蹤 / Ensures structure decisions are tracked in specs
+> - 執行 `/docs` 產生專案文件（README、ARCHITECTURE.md 等） — 讓結構決策有文件記錄 / Document structure decisions
+> - 執行 `/ai-friendly-architecture` 設定 AI 上下文配置 — 讓 AI 助手更好地理解專案結構 / Help AI assistants understand the project structure
+
+---
+
+## Related Standards
+
+- [Core: Project Structure](../../core/project-structure.md)
+- [Core: Documentation Structure](../../core/documentation-structure.md)
+- [Guide: File Placement Decision Guide](../../core/guides/file-placement-guide.md)
+- [AI: Project Structure Options](../../ai/options/project-structure/)

package/bundled/locales/zh-CN/skills/retrospective-assistant/SKILL.md

@@ -28,3 +28,41 @@ description: |
 
 - 核心规范：[retrospective-standards.md](../../../../core/retrospective-standards.md)
 - 详细指南：[guide.md](./guide.md)
+
+
+## Next Steps Guidance | 下一步引導
+
+After `/retrospective` completes:
+
+> **Retrospective complete. Suggested next steps:**
+> - Commit the retrospective report: `/commit`
+> - Create ADRs for architectural decisions identified: `/adr`
+> - Track action items in your issue tracker
+> - Schedule next retrospective
+
+> **回顧完成。建議下一步：**
+> - 提交回顧報告：`/commit`
+> - 為識別的架構決策建立 ADR：`/adr`
+> - 在 issue tracker 中追蹤行動項目
+> - 排定下次回顧
+
+## AI Agent Behavior | AI 代理行為
+
+When `/retrospective` is invoked:
+
+1. **Check type** — Sprint (default) or Release
+2. **Gather data** — Scan git log, check `docs/retrospectives/` for previous actions
+3. **Guide technique** — Use Start-Stop-Continue by default, or specified technique
+4. **Generate report** — Write to `docs/retrospectives/RETRO-YYYY-MM-DD-[type].md`
+5. **Review past actions** — Check previous retro for open action items
+6. **Offer next steps** — Show guidance above
+
+When `/retrospective actions` is invoked:
+1. Scan `docs/retrospectives/` for all retro files
+2. Parse action items from each
+3. Display open/in-progress items as table
+
+## Reference | 參考
+
+- Core Standard: [retrospective-standards.md](../../core/retrospective-standards.md)
+- Detailed Guide: [guide.md](./guide.md)

package/bundled/locales/zh-CN/skills/testing-guide/SKILL.md

@@ -232,3 +232,39 @@ test('method_scenario_expected', () => {
 本 Skill 以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权發布。
 
 **來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
+
+
+## Next Steps Guidance | 下一步引導
+
+After `/testing` completes, the AI assistant should suggest:
+
+> **測試標準與最佳實踐已掌握。建議下一步 / Testing standards and best practices understood. Suggested next steps:**
+> - 執行 `/tdd` 開始測試驅動開發（紅-綠-重構循環） ⭐ **Recommended / 推薦** — 將測試知識立即轉化為實踐 / Turn testing knowledge into practice immediately
+> - 執行 `/coverage` 分析目前程式碼覆蓋率 — 找出測試缺口 / Identify testing gaps
+> - 執行 `/bdd` 撰寫行為驅動的 Given-When-Then 場景 — 從使用者角度定義測試 / Define tests from user perspective
+
+---
+
+## Related Standards
+
+- [Testing Standards](../../core/testing-standards.md) - Actionable rules
+- [Testing Theory](./testing-theory.md) - Educational knowledge base
+- [Code Review Checklist](../../core/code-review-checklist.md)
+
+---
+
+## Version History
+
+| Version | Date | Changes |
+|---------|------|---------|
+| 1.2.0 | 2026-01-29 | Added links to new testing-theory.md knowledge base |
+| 1.1.0 | 2025-12-29 | Added Testing Theory Essentials YAML section |
+| 1.0.0 | 2025-12-24 | Initial: Standard sections (Purpose, Related Standards, Version History, License) |
+
+---
+
+## License
+
+This skill is released under [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/).
+
+**Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

package/bundled/locales/zh-TW/CHANGELOG.md

@@ -1,8 +1,8 @@
 ---
 source: ../../CHANGELOG.md
-source_version: 5.10.0
-translation_version: 5.10.0
-last_synced: 2026-05-13
+source_version: 5.12.1
+translation_version: 5.12.1
+last_synced: 2026-05-19
 status: current
 ---
 
@@ -17,6 +17,52 @@ status: current
 
 ## [Unreleased]
 
+## [5.12.1] - 2026-05-19
+
+### 變更
+- **`full-coverage-testing.ai.yaml`**（`no-tautology-assertions` 規則，XSPEC-220）：AI agent 生成未實作測試骨架時，**必須**使用 `it.todo("AC-XXX: ...")`，禁止使用含 `expect(true).toBe(true)` 的 `it()` callback——無論由人類或 AI agent 生成，均視為 `[ANTI-FAKE-001]` 違規。
+- **`test-governance.ai.yaml`**（`gate-wiring-required` 規則，XSPEC-220）：品質偵測腳本（anti-fake、stub-check、coverage ratchet）**必須**同時出現在至少一個 CI workflow job 與至少一個 local hook。腳本存在於 `scripts/` 但從未被 CI 呼叫，等同不存在，視為治理缺口。
+- **`acceptance-criteria-traceability.ai.yaml`**（`not_implemented` 狀態，XSPEC-220）：明確定義 `it.todo()` 佔位符對應 `not_implemented 🚫` 狀態（不計入覆蓋率分母），補充決策樹區分 `not_implemented`（有意識標記）與 `uncovered`（遺漏）。
+
+## [5.12.0] - 2026-05-16
+
+### 新增
+- **`docs/user/` 使用者文件體系**（XSPEC-211）：新增雙軌文件結構，仿照 VibeOps 慣例，包含 8 份文件：
+  - `docs/user/GETTING-STARTED.md` — 5 分鐘端到端教學（install → `uds init` → `/sdd` → `/commit`）
+  - `docs/user/SKILLS-INDEX.md` — 自動生成的 54 個 skill 索引，依 Tier（DEC-061）與 Category 分類，含「觸發時機速查」表
+  - `docs/user/COMMANDS-INDEX.md` — 自動生成的 48 個 slash command 字母序清單，含 skill 對應
+  - `docs/user/FAQ.md` — 14 題常見問題（安裝、skill、SDD、升級、架構）
+  - `docs/user/GLOSSARY.md` — UDS、SDD、ATDD、BDD、TDD、XSPEC、Dual-Layer、Skill Tier、Standard、Activity、Bundle/Source、ADR、AC 等術語定義
+  - `docs/user/TROUBLESHOOTING.md` — 問題→解法指南，整合 `SKILL-FALLBACK-GUIDE.md` 內容
+  - `docs/user/README.md` — 三類受眾入口（新手 / 日常使用者 / 維護者）+ 文件地圖
+  - `docs/user/CHEATSHEET.md` — 從 `docs/` 移入（內容不變）
+- **`scripts/generate-skill-index.ts`** — 從 `uds-manifest.json` + `skills/*/SKILL.md` frontmatter 生成 SKILLS-INDEX.md 與 COMMANDS-INDEX.md。執行：`npm run docs:generate-index`
+- **`scripts/check-skill-index.ts`** — pre-commit 守門；重生成後 diff，不同步則 exit 非零。執行：`npm run docs:check-index`
+- **`scripts/setup-hooks.sh`** — 安裝 `.git/hooks/pre-commit`，每次 commit 自動呼叫 `docs:check-index`
+- **`.github/workflows/docs-check.yml`** — CI job：PR 修改 manifest/SKILL.md/registry 時驗證 INDEX 文件已同步
+- **`docs/reference/FEATURE-REFERENCE.md`** — FEATURE-REFERENCE.md 從 `docs/` 遷移至 `docs/reference/`（自動生成，內容不變）
+- **`docs/archive/USER-MANUAL-2026-03-24.md`** — 已廢棄 User Manual 的歸檔備份
+
+### 變更
+- **`package.json`**：新增 `docs:generate-index` 與 `docs:check-index` npm scripts
+- **`scripts/generate-usage-docs.mjs`**：更新英文輸出路徑（FEATURE-REFERENCE → `docs/reference/`，CHEATSHEET → `docs/user/`）
+- **`skills/README.md`**：新增 banner 指向 `docs/user/SKILLS-INDEX.md` 與 `COMMANDS-INDEX.md`
+- **`README.md`**：Quick Start 段落新增「📚 Documentation」表格，列出 7 份 `docs/user/` 文件直連
+- **`docs/USER-MANUAL.md`**：新增 deprecation banner 指向 `docs/user/README.md`；歸檔備份保留於 `docs/archive/`
+
+### 移除
+- **`docs/SKILL-FALLBACK-GUIDE.md`**：內容已整合至 `docs/user/TROUBLESHOOTING.md`。非 Claude Code 工具的 fallback 策略與 Skill→Core Standard 對應表保留於「Using UDS Without Claude Code」段落
+
+## [5.11.0] - 2026-05-14
+
+### 新增 / Added
+- **`spec-driven-development`** SPEC Type Agent 變體：`acceptance-criteria-traceability.ai.yaml` 與 SDD 模板新增 `spec-type: feature | agent | infrastructure` 欄位，以及 Agent SPEC 五段式模板（能力範圍 / 決策邊界 / 可觀測性 / 失敗模式 / 跨 Agent 不變量）。讓 Builder/QA/Planner 風格的 SPEC 可獨立於 feature SPEC 追蹤，並透過新增的 `agent-id` 欄位連回特定 Agent。(XSPEC-205)
+- **`reverse-engineering-standards`** 移植清單雙向驗證：新增路由驅動的發現方法（禁止以 filesystem-glob 為起點）、target→source 雙向掃描，以及對「無對應來源產物」的發現的 `[GAP]` 標記協議。搭配 `testing.ai.yaml` 新增 `migration_testing` 區段，要求以 3 步驟 schema parity pattern 並由 CI gate 強制執行。關閉 UDS Issue #96 與 #97。(XSPEC-206)
+
+### 修復 / Fixed
+- **`uds update` 對 schema 3.x manifest 誤報「CLAUDE.md.md：無法判斷來源」還原失敗**（`cli/src/utils/integration-generator.js`、`cli/src/commands/update.js`）：schema 3.x manifest 在 `manifest.integrations` 存的是**檔名**（如 `"CLAUDE.md"`）而非工具名。`integration-generator.js:56` 的 `getToolFileName` fallback 無條件附加 `".md"`，導致 `getToolFilePath("CLAUDE.md")` 回傳 `"CLAUDE.md.md"`，被當成遺失檔案而無法還原（`getSourcePathFromRelative` 對該合成路徑沒有 mapping）。Commit `79532b3`（5.10.0）修了反向案例（工具名輸入），但漏這個檔名變體。修補：從 `SUPPORTED_AI_TOOLS` 預計算 `KNOWN_TOOL_FILES`，對已知整合檔名或已含已知副檔名（`.md`/`.yaml`/`.yml`/`.json`）的輸入短路回傳。`integration-generator.test.js` 新增 5 個 regression test。(XSPEC-208 BUG-208-01)
+- **`uds update` / `uds check` 誤報「Integration UDS Block Integrity：GEMINI.md/AGENTS.md 遺失」警告**（`cli/src/commands/update.js`、`cli/src/i18n/messages.js`）：`manifest.integrationBlockHashes` 每次安裝都累加但從不清理。當 `manifest.aiTools` 縮減（如 `["claude-code","gemini-cli"]` → `["claude-code"]`），GEMINI.md 的 hash 仍殘留，`check.js:1491 checkIntegrationBlocksIntegrity` 誤報該檔遺失。修補：在 integration 重生步驟後，依 `manifest.aiTools`（宣告的設定，而非 `results.integrations`，後者在暫時性寫入失敗時會 over-prune）反推預期檔名集合並移除孤兒 hash。被清理的檔名透過新增 i18n key `prunedOrphanedBlockHashes`（en / zh-TW / zh-CN）回報。`update.test.js` 新增 3 個 regression test。在 machine-setup `uds update` 5.1.0-beta.4 → 5.10.0 觸發；於 5.10.0 → 5.11.0 驗證修復。(XSPEC-208 BUG-208-02)
+
 ## [5.10.0] - 2026-05-13
 
 ### 新增

package/bundled/locales/zh-TW/CLAUDE.md

@@ -14,7 +14,7 @@ status: current
 
 Universal Development Standards 是一個語言無關、框架無關的文件化標準框架。它提供：
 
-- **核心規範** (`core/`)：71 個基礎開發標準
+- **核心規範** (`core/`)：125 個基礎開發標準
 - **AI 技能** (`skills/`)：用於 AI 輔助開發的 Claude Code 技能
 - **CLI 工具** (`cli/`)：用於採用標準的 Node.js CLI
 - **整合** (`integrations/`)：各種 AI 工具的配置

package/bundled/locales/zh-TW/README.md

@@ -14,7 +14,7 @@ status: current
 
 > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
 
-**版本**: 5.10.0 | **發布日期**: 2026-04-13 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 5.12.1 | **發布日期**: 2026-05-14 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
 
 語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流，確保不同技術堆疊之間的一致性、品質和可維護性。
 
@@ -63,8 +63,8 @@ npx universal-dev-standards init
 <!-- UDS_STATS_TABLE_START -->
 | 類別 | 數量 | 說明 |
 |----------|-------|-------------|
-| **核心標準** | 78 | 通用開發準則 |
-| **AI Skills** | 48 | 互動式技能 |
+| **核心標準** | 125 | 通用開發準則 |
+| **AI Skills** | 54 | 互動式技能 |
 | **斜線命令** | 48 | 快速操作 |
 | **CLI 指令** | 6 | list, init, configure, check, update, skills |
 <!-- UDS_STATS_TABLE_END -->

package/bundled/locales/zh-TW/SECURITY.md

@@ -13,8 +13,7 @@ status: current
 <!-- UDS_SUPPORTED_VERSIONS_START -->
 | 版本 | 支援狀態 |
 |------|--------|
-| 5.1.0-beta.5 | ✅ 預發布版本 |
-| 5.0.0 | ✅ 最新正式版 |
+| 5.11.0 | ✅ 最新正式版 |
 | < 5.0.0 | ❌ 已終止支援 |
 <!-- UDS_SUPPORTED_VERSIONS_END -->