universal-dev-standards 5.0.0 → 5.1.0-beta.1

package/bundled/locales/zh-CN/core/ai-response-navigation.md

@@ -0,0 +1,297 @@
+---
+source: ../../../core/ai-response-navigation.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+# AI 响应导航标准
+
+> **语言**: [English](../../../core/ai-response-navigation.md) | [繁體中文](../../zh-TW/core/ai-response-navigation.md) | 简体中文
+
+**版本**: 1.0.0
+**最后更新**: 2026-03-25
+**适用范围**: 所有使用 AI 辅助开发的项目
+**范围**: universal
+**行业标准**: 无（新兴 AI 工具实践）
+**参考**: [SPEC-STD-08](../../../docs/specs/standards/SPEC-STD-08-ai-response-navigation.md)
+
+---
+
+## 目的
+
+本标准定义 AI 响应的导航行为：每个实质性的 AI 响应必须包含情境化的下一步建议与推荐选项。确保用户在开发工作流程中持续被引导，无需记忆所有可用命令。
+
+**问题**：用户在收到 AI 响应后不知道下一步该做什么。面对 30+ 个斜杠命令，认知负担高且工作流程连续性中断。
+
+**解决方案**：在每个实质性 AI 响应结尾附加标准化的「导航区块」，包含情境模板、推荐标记和弹性选项数量。
+
+---
+
+## 核心规则
+
+### 规则 1：每个实质性响应都包含导航
+
+每个构成「逻辑响应单元」的 AI 响应必须以导航区块作为结尾。
+
+**以下情况视为逻辑响应单元：**
+
+1. 完成了一项任务或子任务
+2. 提供了分析、解释或建议
+3. 向用户询问问题或要求选择
+4. 报告了错误或异常状态
+5. 展示了代码变更结果
+
+**豁免**：极短确认回复（如「好的」「已完成」「了解」）不构成独立的逻辑单元，可以省略导航区块。
+
+### 规则 2：推荐并说明理由
+
+提供多个选项时，使用 ⭐ **推荐** 标记最佳选项，并在 ` — ` 之后附上理由。
+
+| 情境 | 标记方式 |
+|------|----------|
+| 有一个选项明显较优 | ⭐ **推荐** — [理由] |
+| 各选项无明显优劣 | 说明各选项适用场景，不标记 ⭐ |
+| 只有一个合理的下一步 | 直接建议，不需要 ⭐ |
+
+### 规则 3：匹配情境
+
+根据响应类型使用对应的模板（参见[情境模板](#情境模板)）。
+
+### 规则 4：弹性数量
+
+根据情境复杂度调整选项数量：
+
+| 情境 | 选项数量 | 理由 |
+|------|----------|------|
+| 任务完成 | 2–3 | 建议后续工作流程步骤 |
+| 用户询问 | 2–5 | 依问题复杂度调整 |
+| 错误/失败 | 1–3 | 聚焦修复方向 |
+| 进行中 | 1–2 | 继续或调整 |
+| 信息回复 | 1–3 | 探索方向 |
+
+**硬性上限**：不得超过 5 个选项。裁减至最相关的选项。
+
+### 规则 5：优先使用斜杠命令
+
+当下一步建议对应到已知的斜杠命令时，使用 `` `/command` `` 格式引用，让用户可以直接复制执行。没有对应命令的步骤使用自然语言描述。
+
+---
+
+## 情境模板
+
+### 模板 1：任务完成
+
+任务、技能执行或代码修改完成时使用。
+
+```markdown
+> **建议下一步：**
+> - 执行 `/command1` 做 X
+> - 执行 `/command2` 做 Y ⭐ **推荐** — [理由]
+> - 执行 `/command3` 做 Z
+```
+
+### 模板 2：用户询问
+
+AI 需要用户做出选择或提供信息时使用。
+
+```markdown
+> **请选择：**
+> - **(A) 选项描述** — 补充说明
+> - **(B) 选项描述** ⭐ **推荐** — [理由]
+> - **(C) 选项描述** — 补充说明
+```
+
+### 模板 3：错误/失败
+
+报告错误、失败或异常状态时使用。
+
+```markdown
+> **建议修复方向：**
+> - 选项描述 ⭐ **推荐** — [理由]
+> - 选项描述
+```
+
+### 模板 4：进行中
+
+完成多步骤任务的中间阶段时使用。
+
+```markdown
+> **当前进度：[N/M]。下一步：**
+> - 继续下一阶段 ⭐ **推荐**
+> - 调整方向或参数
+```
+
+### 模板 5：信息回复
+
+回答知识性问题或提供说明时使用。
+
+```markdown
+> **建议下一步：**
+> - 深入了解 [相关主题]
+> - 执行 `/command` 将知识应用到实现
+```
+
+---
+
+## 格式规范
+
+### 结构
+
+所有导航区块使用 Markdown 引用区块（`>`）：
+
+```markdown
+> **[标题]：**
+> - [选项/建议] ⭐ **推荐** — [理由]
+> - [选项/建议] — [补充说明]
+```
+
+### 依情境的标题
+
+| 情境 | 标题 |
+|------|------|
+| 任务完成 | `建议下一步` |
+| 用户询问 | `请选择` |
+| 错误/失败 | `建议修复方向` |
+| 进行中 | `当前进度：[N/M]。下一步` |
+| 信息回复 | `建议下一步` |
+
+### 本地化
+
+对于双语项目，导航区块遵循对话语言。本地化对照：
+
+| English | 繁體中文 | 简体中文 |
+|---------|----------|----------|
+| Suggested next steps | 建議下一步 | 建议下一步 |
+| Please choose | 請選擇 | 请选择 |
+| Suggested resolution | 建議修復方向 | 建议修复方向 |
+| Progress: [N/M]. Next | 目前進度：[N/M]。下一步 | 当前进度：[N/M]。下一步 |
+| Recommended | 推薦 | 推荐 |
+
+---
+
+## 与技能的整合
+
+### 现有技能
+
+已有 `## Next Steps Guidance | 下一步引导` 区块的技能：
+
+1. **保留**技能特有的场景化建议内容
+2. **对齐**格式以符合本标准定义的模板
+3. **加入**推荐标记（⭐）
+
+### 新技能
+
+新技能应包含遵循本标准模板的 `## Next Steps Guidance | 下一步引导` 区块。
+
+### 超越技能
+
+本标准适用于**所有 AI 响应**，不仅限于技能执行。一般对话、代码审查、调试过程及任何其他交互，在产生实质性响应时都必须遵循这些导航规则。
+
+---
+
+## 跨 AI 工具适用性
+
+本标准与工具无关。适用于所有使用 UDS 标准的 AI 工具：
+
+- Claude Code
+- Cursor
+- Windsurf
+- GitHub Copilot
+- Cline
+- Roo Code
+- Augment Code
+- Trae
+- 其他兼容工具
+
+每个工具的集成层负责根据其 UI 能力渲染导航区块，但行为规则保持一致。
+
+---
+
+## 示例
+
+### 示例 1：完成功能实现后
+
+```markdown
+> **建议下一步：**
+> - 执行 `/test` 为新功能编写测试
+> - 执行 `/commit` 提交变更 ⭐ **推荐** — 变更已完整且通过验证
+> - 执行 `/review` 进行自我审查
+```
+
+### 示例 2：询问用户设计问题
+
+```markdown
+> **请选择：**
+> - **(A) 使用新的数据库表** — 更灵活，迁移成本较高
+> - **(B) 扩展现有表增加列** ⭐ **推荐** — 迁移更简单，满足当前需求
+> - **(C) 使用 NoSQL 存储** — 适合非结构化数据但增加基础设施
+```
+
+### 示例 3：报告测试失败
+
+```markdown
+> **建议修复方向：**
+> - 检查 `tests/auth.test.js:42` 的失败断言 ⭐ **推荐** — 错误信息指向空引用
+> - 执行 `/debug` 进行系统性调试
+> - 还原上次变更并调查
+```
+
+### 示例 4：工作流程中间进度更新
+
+```markdown
+> **当前进度：[2/5]。下一步：**
+> - 继续第 3 阶段：实现 ⭐ **推荐**
+> - 在继续前重新检视第 2 阶段需求
+```
+
+### 示例 5：回答技术问题
+
+```markdown
+> **建议下一步：**
+> - 探索 `config/auth.yaml` 中的相关配置
+> - 执行 `/sdd` 创建规格（若计划修改此行为）
+```
+
+---
+
+## 快速参考卡
+
+| 规则 | 摘要 |
+|------|------|
+| R1 | 每个实质性响应 → 导航区块 |
+| R2 | 多选项 → ⭐ 标记最佳 + 理由 |
+| R3 | 模板匹配响应类型 |
+| R4 | 1–5 个选项，依情境调整 |
+| R5 | 适用时使用 `/command` 格式 |
+
+| 豁免 | 不豁免 |
+|------|--------|
+| 「好的」「已完成」「了解」 | 任务完成报告 |
+| 单词确认回复 | 错误说明 |
+| | 分析或建议 |
+| | 向用户提问 |
+| | 代码变更摘要 |
+
+---
+
+## 相关标准
+
+- [AI 命令行为标准](ai-command-behavior.md) — 定义 AI 如何执行命令（互补：行为 = 执行，导航 = 响应后引导）
+- [AI 指令标准](ai-instruction-standards.md) — AI 指令文件的结构
+- [AI 协议标准](ai-agreement-standards.md) — 人机协作协议
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.0.0 | 2026-03-25 | 初始版本 |
+
+---
+
+## 许可
+
+本标准以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 许可发布。

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

@@ -6,7 +6,7 @@
 
 > **語言**: [English](../../README.md) | 繁體中文 | [简体中文](../zh-CN/README.md)
 
-**版本**: 5.0.0 | **發布日期**: 2026-03-24 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
+**版本**: 5.1.0-beta.1 | **發布日期**: 2026-03-25 | **授權**: [雙重授權](../../LICENSE) (CC BY 4.0 + MIT)
 
 語言無關、框架無關的軟體專案文件標準。透過 AI 原生工作流，確保不同技術堆疊之間的一致性、品質和可維護性。
 

package/bundled/locales/zh-TW/core/ai-response-navigation.md

@@ -0,0 +1,297 @@
+---
+source: ../../../core/ai-response-navigation.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+# AI 回應導航標準
+
+> **語言**: [English](../../../core/ai-response-navigation.md) | 繁體中文 | [简体中文](../../zh-CN/core/ai-response-navigation.md)
+
+**版本**: 1.0.0
+**最後更新**: 2026-03-25
+**適用範圍**: 所有使用 AI 輔助開發的專案
+**範圍**: universal
+**產業標準**: 無（新興 AI 工具實踐）
+**參考**: [SPEC-STD-08](../../../docs/specs/standards/SPEC-STD-08-ai-response-navigation.md)
+
+---
+
+## 目的
+
+本標準定義 AI 回應的導航行為：每個實質性的 AI 回應必須包含情境化的下一步建議與推薦選項。確保使用者在開發工作流程中持續被引導，無需記憶所有可用命令。
+
+**問題**：使用者在收到 AI 回應後不知道下一步該做什麼。面對 30+ 個斜線命令，認知負擔高且工作流程連續性中斷。
+
+**解決方案**：在每個實質性 AI 回應結尾附加標準化的「導航區塊」，包含情境模板、推薦標記和彈性選項數量。
+
+---
+
+## 核心規則
+
+### 規則 1：每個實質性回應都包含導航
+
+每個構成「邏輯回應單元」的 AI 回應必須以導航區塊作為結尾。
+
+**以下情況視為邏輯回應單元：**
+
+1. 完成了一項任務或子任務
+2. 提供了分析、解釋或建議
+3. 向使用者詢問問題或要求選擇
+4. 報告了錯誤或異常狀態
+5. 展示了程式碼變更結果
+
+**豁免**：極短確認回覆（如「好的」「已完成」「了解」）不構成獨立的邏輯單元，可以省略導航區塊。
+
+### 規則 2：推薦並說明理由
+
+提供多個選項時，使用 ⭐ **推薦** 標記最佳選項，並在 ` — ` 之後附上理由。
+
+| 情境 | 標記方式 |
+|------|----------|
+| 有一個選項明顯較優 | ⭐ **推薦** — [理由] |
+| 各選項無明顯優劣 | 說明各選項適用場景，不標記 ⭐ |
+| 只有一個合理的下一步 | 直接建議，不需要 ⭐ |
+
+### 規則 3：匹配情境
+
+根據回應類型使用對應的模板（參見[情境模板](#情境模板)）。
+
+### 規則 4：彈性數量
+
+根據情境複雜度調整選項數量：
+
+| 情境 | 選項數量 | 理由 |
+|------|----------|------|
+| 任務完成 | 2–3 | 建議後續工作流程步驟 |
+| 使用者詢問 | 2–5 | 依問題複雜度調整 |
+| 錯誤/失敗 | 1–3 | 聚焦修復方向 |
+| 進行中 | 1–2 | 繼續或調整 |
+| 資訊回覆 | 1–3 | 探索方向 |
+
+**硬性上限**：不得超過 5 個選項。裁減至最相關的選項。
+
+### 規則 5：優先使用斜線命令
+
+當下一步建議對應到已知的斜線命令時，使用 `` `/command` `` 格式引用，讓使用者可以直接複製執行。沒有對應命令的步驟使用自然語言描述。
+
+---
+
+## 情境模板
+
+### 模板 1：任務完成
+
+任務、技能執行或程式碼修改完成時使用。
+
+```markdown
+> **建議下一步：**
+> - 執行 `/command1` 做 X
+> - 執行 `/command2` 做 Y ⭐ **推薦** — [理由]
+> - 執行 `/command3` 做 Z
+```
+
+### 模板 2：使用者詢問
+
+AI 需要使用者做出選擇或提供資訊時使用。
+
+```markdown
+> **請選擇：**
+> - **(A) 選項描述** — 補充說明
+> - **(B) 選項描述** ⭐ **推薦** — [理由]
+> - **(C) 選項描述** — 補充說明
+```
+
+### 模板 3：錯誤/失敗
+
+報告錯誤、失敗或異常狀態時使用。
+
+```markdown
+> **建議修復方向：**
+> - 選項描述 ⭐ **推薦** — [理由]
+> - 選項描述
+```
+
+### 模板 4：進行中
+
+完成多步驟任務的中間階段時使用。
+
+```markdown
+> **目前進度：[N/M]。下一步：**
+> - 繼續下一階段 ⭐ **推薦**
+> - 調整方向或參數
+```
+
+### 模板 5：資訊回覆
+
+回答知識性問題或提供說明時使用。
+
+```markdown
+> **建議下一步：**
+> - 深入了解 [相關主題]
+> - 執行 `/command` 將知識應用到實作
+```
+
+---
+
+## 格式規範
+
+### 結構
+
+所有導航區塊使用 Markdown 引用區塊（`>`）：
+
+```markdown
+> **[標題]：**
+> - [選項/建議] ⭐ **推薦** — [理由]
+> - [選項/建議] — [補充說明]
+```
+
+### 依情境的標題
+
+| 情境 | 標題 |
+|------|------|
+| 任務完成 | `建議下一步` |
+| 使用者詢問 | `請選擇` |
+| 錯誤/失敗 | `建議修復方向` |
+| 進行中 | `目前進度：[N/M]。下一步` |
+| 資訊回覆 | `建議下一步` |
+
+### 本地化
+
+對於雙語專案，導航區塊遵循對話語言。本地化對照：
+
+| English | 繁體中文 | 简体中文 |
+|---------|----------|----------|
+| Suggested next steps | 建議下一步 | 建议下一步 |
+| Please choose | 請選擇 | 请选择 |
+| Suggested resolution | 建議修復方向 | 建议修复方向 |
+| Progress: [N/M]. Next | 目前進度：[N/M]。下一步 | 当前进度：[N/M]。下一步 |
+| Recommended | 推薦 | 推荐 |
+
+---
+
+## 與技能的整合
+
+### 現有技能
+
+已有 `## Next Steps Guidance | 下一步引導` 區塊的技能：
+
+1. **保留**技能特有的場景化建議內容
+2. **對齊**格式以符合本標準定義的模板
+3. **加入**推薦標記（⭐）
+
+### 新技能
+
+新技能應包含遵循本標準模板的 `## Next Steps Guidance | 下一步引導` 區塊。
+
+### 超越技能
+
+本標準適用於**所有 AI 回應**，不僅限於技能執行。一般對話、程式碼審查、除錯過程及任何其他互動，在產生實質性回應時都必須遵循這些導航規則。
+
+---
+
+## 跨 AI 工具適用性
+
+本標準與工具無關。適用於所有使用 UDS 標準的 AI 工具：
+
+- Claude Code
+- Cursor
+- Windsurf
+- GitHub Copilot
+- Cline
+- Roo Code
+- Augment Code
+- Trae
+- 其他相容工具
+
+每個工具的整合層負責根據其 UI 能力渲染導航區塊，但行為規則保持一致。
+
+---
+
+## 範例
+
+### 範例 1：完成功能實作後
+
+```markdown
+> **建議下一步：**
+> - 執行 `/test` 為新功能撰寫測試
+> - 執行 `/commit` 提交變更 ⭐ **推薦** — 變更已完整且通過驗證
+> - 執行 `/review` 進行自我審查
+```
+
+### 範例 2：詢問使用者設計問題
+
+```markdown
+> **請選擇：**
+> - **(A) 使用新的資料庫表** — 更靈活，遷移成本較高
+> - **(B) 擴展現有表增加欄位** ⭐ **推薦** — 遷移更簡單，滿足當前需求
+> - **(C) 使用 NoSQL 儲存** — 適合非結構化資料但增加基礎設施
+```
+
+### 範例 3：報告測試失敗
+
+```markdown
+> **建議修復方向：**
+> - 檢查 `tests/auth.test.js:42` 的失敗斷言 ⭐ **推薦** — 錯誤訊息指向空引用
+> - 執行 `/debug` 進行系統性除錯
+> - 還原上次變更並調查
+```
+
+### 範例 4：工作流程中間進度更新
+
+```markdown
+> **目前進度：[2/5]。下一步：**
+> - 繼續第 3 階段：實作 ⭐ **推薦**
+> - 在繼續前重新檢視第 2 階段需求
+```
+
+### 範例 5：回答技術問題
+
+```markdown
+> **建議下一步：**
+> - 探索 `config/auth.yaml` 中的相關配置
+> - 執行 `/sdd` 建立規格（若計畫修改此行為）
+```
+
+---
+
+## 快速參考卡
+
+| 規則 | 摘要 |
+|------|------|
+| R1 | 每個實質性回應 → 導航區塊 |
+| R2 | 多選項 → ⭐ 標記最佳 + 理由 |
+| R3 | 模板匹配回應類型 |
+| R4 | 1–5 個選項，依情境調整 |
+| R5 | 適用時使用 `/command` 格式 |
+
+| 豁免 | 不豁免 |
+|------|--------|
+| 「好的」「已完成」「了解」 | 任務完成報告 |
+| 單詞確認回覆 | 錯誤說明 |
+| | 分析或建議 |
+| | 向使用者提問 |
+| | 程式碼變更摘要 |
+
+---
+
+## 相關標準
+
+- [AI 命令行為標準](ai-command-behavior.md) — 定義 AI 如何執行命令（互補：行為 = 執行，導航 = 回應後引導）
+- [AI 指令標準](ai-instruction-standards.md) — AI 指令檔案的結構
+- [AI 協議標準](ai-agreement-standards.md) — 人機協作協議
+
+---
+
+## 版本歷史
+
+| 版本 | 日期 | 變更 |
+|------|------|------|
+| 1.0.0 | 2026-03-25 | 初始版本 |
+
+---
+
+## 授權
+
+本標準以 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授權釋出。

package/bundled/skills/ac-coverage-assistant/SKILL.md

@@ -109,7 +109,7 @@ After `/ac-coverage` completes, the AI assistant should suggest:
 
 > **AC 覆蓋率分析完成。建議下一步 / AC coverage analysis complete. Suggested next steps:**
 > - 覆蓋率達標 → 執行 `/checkin` 品質關卡 — Coverage meets threshold → Run `/checkin` quality gates
-> - 有未覆蓋 AC → 執行 `/derive-tdd` 補齊測試 — Uncovered AC found → Run `/derive-tdd` to add tests
+> - 有未覆蓋 AC → 執行 `/derive-tdd` 補齊測試 ⭐ **Recommended / 推薦** — Uncovered AC found → Run `/derive-tdd` to add tests
 > - 有部分覆蓋 AC → 檢查缺少的邊界情況 — Partial AC → Review missing edge cases
 
 ## Reference | 參考

package/bundled/skills/ai-collaboration-standards/SKILL.md

@@ -184,6 +184,17 @@ This project uses **English** certainty tags.
 
 ---
 
+## 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)

package/bundled/skills/ai-friendly-architecture/SKILL.md

@@ -202,6 +202,17 @@ If no configuration found:
 
 ---
 
+## 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

package/bundled/skills/ai-instruction-standards/SKILL.md

@@ -195,6 +195,17 @@ If no AI instruction file found:
 
 ---
 
+## Next Steps Guidance | 下一步引導
+
+After `/ai-instructions` completes, the AI assistant should suggest:
+
+> **AI 指令檔案標準已掌握。建議下一步 / AI instruction file standards understood. Suggested next steps:**
+> - 建立或更新專案的 `CLAUDE.md`（或對應的 AI 指令檔案） ⭐ **Recommended / 推薦** — 立即將標準應用到專案中 / Apply standards to the project immediately
+> - 執行 `/ai-friendly-architecture` 從架構層面優化 AI 協作 — 配合指令檔案提升 AI 理解力 / Enhance AI understanding alongside instruction files
+> - 執行 `/ai-collaboration` 複習 AI 行為準則 — 確保指令檔案中的規則與行為標準一致 / Ensure instruction file rules align with behavior standards
+
+---
+
 ## Related Standards
 
 - [AI Instruction File Standards](../../core/ai-instruction-standards.md) - Core standard

package/bundled/skills/api-design-assistant/SKILL.md

@@ -99,7 +99,7 @@ Produce OpenAPI/Swagger specs or GraphQL schema documentation.
 After `/api-design` completes, the AI assistant should suggest:
 
 > **API 設計完成。建議下一步 / API design complete. Suggested next steps:**
-> - 執行 `/sdd` 建立正式規格文件 — Create formal specification
+> - 執行 `/sdd` 建立正式規格文件 ⭐ **Recommended / 推薦** — Create formal specification
 > - 執行 `/testing` 規劃 API 測試策略 — Plan API testing strategy
 > - 執行 `/docs` 產生 API 文件 — Generate API documentation
 > - 審查安全性 → 執行 `/security` — Review security → Run `/security`

package/bundled/skills/atdd-assistant/SKILL.md

@@ -73,7 +73,7 @@ So that [benefit].
 After `/atdd` completes, the AI assistant should suggest:
 
 > **驗收測試已定義。建議下一步 / Acceptance tests defined. Suggested next steps:**
-> - 執行 `/sdd` 建立規格文件 — Create a specification document
+> - 執行 `/sdd` 建立規格文件 ⭐ **Recommended / 推薦** — Create a specification document
 > - 執行 `/bdd` 將 AC 轉為 Gherkin 場景 — Convert AC to Gherkin scenarios
 > - 執行 `/tdd` 直接實作驗收測試 — Implement acceptance tests directly
 

package/bundled/skills/audit-assistant/SKILL.md

@@ -111,7 +111,7 @@ After running audit:
 
 | Finding | Action | 建議動作 |
 |---------|--------|---------|
-| Health ERROR | Run `uds init` or `uds check --restore` | 執行修復指令 |
+| Health ERROR ⭐ **Recommended / 推薦** | Run `uds init` or `uds check --restore` | 執行修復指令 |
 | Pattern detected | Consider requesting new standard via `--report` | 考慮透過 `--report` 請求新標準 |
 | Modified standard | Review if standard needs more flexibility | 檢視標準是否需要更多彈性 |
 | Unused standard | Consider removing with `uds uninstall` | 考慮移除未使用標準 |