universal-dev-standards 5.17.0 → 6.1.0

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

@@ -1,85 +1,110 @@
 ---
 name: logging
 description: |
-  实作结构化日誌，包含正确的日誌层级和敏感数据处理。
-  使用时机：新增日誌、除錯、设置可觀测性。
-  关鍵字：logging, log level, structured logging, observability, 日誌, 记录, 结构化日誌。
+  实现结构化日志，包含正确的日志级别和敏感数据处理。
+  使用时机：新增日志、调试、设置可观测性。
+  关键字：logging, log level, structured logging, observability, 日志, 记录, 结构化日志。
 source: ../../../../skills/logging-guide/SKILL.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-01-08
+source_version: 1.4.0
+translation_version: 1.4.0
+last_synced: 2026-07-08
+source_hash: cf114de1df86
 status: current
 ---
 
-# 日誌指南
+# 日志指南
 
 > **语言**: [English](../../../../skills/logging-guide/SKILL.md) | 简体中文
 
-**版本**: 1.0.0
-**最後更新**: 2025-12-30
-**適用範圍**: Claude Code Skills
+**版本**: 1.4.0
+**最后更新**: 2026-06-19
+**适用范围**: Claude Code Skills
 
 ---
 
+> **核心标准**: 本技能实现 [日志标准](../../../../core/logging-standards.md)。如需面向任何 AI 工具的完整方法论文档，请参阅核心标准。
+
 ## 目的
 
-此技能幫助在所有環境中实作一致、结构化且可操作的应用程序日誌。
+此技能帮助在所有环境中实现一致、结构化且可操作的应用程序日志。
 
-## 快速參考
+## 快速参考
 
-### 日誌层级
+### 日志级别
 
-| 层级 | 代码 | 使用时机 | 生产環境 |
+| 级别 | 代码 | 使用时机 | 生产环境 |
 |------|------|----------|----------|
-| **TRACE** | 10 | 非常详细的除錯信息 | 关閉 |
-| **DEBUG** | 20 | 详细的除錯信息 | 关閉 |
-| **INFO** | 30 | 正常操作事件 | 開啟 |
-| **WARN** | 40 | 潛在問題，可恢復 | 開啟 |
-| **ERROR** | 50 | 需要注意的错误 | 開啟 |
-| **FATAL** | 60 | 嚴重故障 | 開啟 |
+| **TRACE** | 10 | 非常详细的调试信息 | 关闭 |
+| **DEBUG** | 20 | 详细的调试信息 | 关闭 |
+| **INFO** | 30 | 正常操作事件 | 开启 |
+| **WARN** | 40 | 潜在问题，可恢复 | 开启 |
+| **ERROR** | 50 | 需要关注的错误 | 开启 |
+| **FATAL** | 60 | 严重故障 | 开启 |
 
-### 层级选择决策樹
+### 级别选择决策树
 
 ```
-只用於除錯？               → DEBUG（生产環境关閉）
+只用于调试？               → DEBUG（生产环境关闭）
 正常操作完成？             → INFO
-意外但没問題的情况？       → WARN
+意外但没问题的情况？       → WARN
 操作失败？                 → ERROR
-应用程序無法繼續？         → FATAL
+应用程序无法继续？         → FATAL
 ```
 
-### 各层级使用时机
+### 各级别使用时机
 
-| 层级 | 範例 |
+| 级别 | 示例 |
 |------|------|
-| **TRACE** | 函式进入/離開、回圈迭代、变數值 |
-| **DEBUG** | 状态变更、设置值、查詢參數 |
-| **INFO** | 应用啟动/关閉、使用者操作、排程任务 |
-| **WARN** | 已棄用 API、重試嘗試、資源接近上限 |
-| **ERROR** | 失败的操作、捕獲的例外、集成失败 |
-| **FATAL** | 無法恢復的错误、啟动失败、失去关鍵資源 |
+| **TRACE** | 函数进入/退出、循环迭代、变量值 |
+| **DEBUG** | 状态变更、配置值、查询参数 |
+| **INFO** | 应用启动/关闭、用户操作、定时任务 |
+| **WARN** | 已弃用 API、重试尝试、资源接近上限 |
+| **ERROR** | 失败的操作、捕获的异常、集成失败 |
+| **FATAL** | 无法恢复的错误、启动失败、失去关键资源 |
+
+## 强制事件
+
+把每条日志格式化得再完美，但**在真正关键的时刻却从不触发**，比什么都没有还糟——它会在事故当下给人虚假的安全感。核心标准定义了**9 个必须产生日志记录的标准事件**。若日志配置遵守级别／字段规则却遗漏这些事件，就是「规范上合格、实质上沉默」。务必全部实现这 9 项：
+
+| 事件 id | 时机 | 级别 | 核心必要字段 | 不可记录 |
+|----------|------|-------|----------------------|--------------|
+| `application_startup` | 启动后、**接受请求前** | INFO | app_name, version, git_sha, environment, hostname, pid, listening_endpoints | secrets、完整连接字符串 |
+| `request_received` | Middleware 首次看到请求时 | INFO / DEBUG | method, path, source_ip, request_id | request body、auth headers |
+| `validation_failure` | schema / ModelState / DTO 验证拒绝时 | WARN | request_id, path, missing_fields[], payload_shape（仅 keys） | 字段**值**、PII |
+| `authentication_failure` | 登录 / token 验证失败时 | WARN | uid（尝试值）, source_ip, failure_reason | password、token 值 |
+| `outbound_call_start` | 发起对外 HTTP/RPC 调用时 | INFO | target_url（host+path）, 传递的 request_id, timeout_ms | credentials、bearer tokens |
+| `outbound_call_complete` | 外部调用返回或失败时 | INFO / WARN / ERROR | status_code **或** failure_phase（dns/tcp/tls/http）, elapsed_ms, retries | 含 PII 的 response body |
+| `business_event` | 状态变更类业务操作完成时 | INFO | operation_name, actor, target ids, outcome | 完整 record payload、PII |
+| `heartbeat` | 长期运行的后台服务，≥ 1 次 / 60 秒 | INFO | service_name, queue_depth, items_processed_since_last_heartbeat | — |
+| `shutdown` | 进程退出时（正常或致命错误） | INFO / ERROR | app_name, signal/reason, uptime_seconds, pending_work_count | — |
+
+**为何是这些事件**——每一项都补上一个真实的事故盲区：静默的 `validation_failure` 会隐藏未记录的 payload；`authentication_failure` 若缺 `uid`／`source_ip` 就无法调查；缺少 `heartbeat` 意味着 0-byte 的日志文件不会被察觉；没有 `outbound_call_*` 会让「发送失败」变成一场找不到任何调用痕迹、耗时 2 天的排查。
 
-## 结构化日誌
+> 后台服务若在 60 秒内未写入任何 INFO/WARN/ERROR，**必须**发出一条 `heartbeat`；若连续 ≥ 2 倍间隔（≥ 120 秒）都没有出现，静默检测器**必须**告警。
 
-### 必要欄位
+完整目录（每个事件的 `when`／`must_log`／`must_NOT_log`／`rationale` 及合规示例），请参见核心 [Logging Standards](../../core/logging-standards.md#强制事件mandatory-events) 的 **强制事件** 章节。
+
+## 结构化日志
+
+### 必要字段
 
 ```json
 {
   "timestamp": "2025-01-15T10:30:00.123Z",
   "level": "INFO",
-  "message": "使用者登入成功",
+  "message": "用户登录成功",
   "service": "auth-service",
   "environment": "production"
 }
 ```
 
-### 建议欄位
+### 推荐字段
 
 ```json
 {
   "timestamp": "2025-01-15T10:30:00.123Z",
   "level": "INFO",
-  "message": "使用者登入成功",
+  "message": "用户登录成功",
   "service": "auth-service",
   "environment": "production",
   "trace_id": "abc123",
@@ -93,67 +118,67 @@ status: current
 }
 ```
 
-### 欄位命名慣例
+### 字段命名规范
 
-使用 `snake_case` 并加上領域前綴：
+使用 `snake_case` 并加上领域前缀：
 
-| 領域 | 常用欄位 |
+| 领域 | 常用字段 |
 |------|----------|
 | HTTP | http_method, http_path, http_status, http_duration_ms |
-| 数据庫 | db_query_type, db_table, db_duration_ms, db_rows_affected |
-| 佇列 | queue_name, queue_message_id, queue_delay_ms |
-| 使用者 | user_id, user_role, user_action |
+| 数据库 | db_query_type, db_table, db_duration_ms, db_rows_affected |
+| 队列 | queue_name, queue_message_id, queue_delay_ms |
+| 用户 | user_id, user_role, user_action |
 | 请求 | request_id, trace_id, span_id |
 
 ## 详细指南
 
-完整标准請參考：
-- [日誌标准](../../../../core/logging-standards.md)
+完整标准请参考：
+- [日志标准](../../../../core/logging-standards.md)
 
-### AI 優化格式（节省 Token）
+### AI 优化格式（节省 Token）
 
-AI 助手可使用 YAML 格式文件以減少 Token 使用量：
-- 基礎标准：`ai/standards/logging.ai.yaml`
+AI 助手可使用 YAML 格式文件以减少 Token 使用量：
+- 基础标准：`ai/standards/logging.ai.yaml`
 
 ## 敏感数据处理
 
-### 絕对不要记录
+### 绝不记录
 
-- 密码或机密
-- API 金鑰或 Token
+- 密码或密钥
+- API 密钥或令牌
 - 信用卡号码
-- 身分证字号
-- 完整的认证 Token
+- 身份证号码
+- 完整的认证令牌
 
-### 遮罩或编修
+### 脱敏处理
 
 ```javascript
 // 不好
-logger.info('登入嘗試', { password: userPassword });
+logger.info('登录尝试', { password: userPassword });
 
 // 好
-logger.info('登入嘗試', { password: '***已编修***' });
+logger.info('登录尝试', { password: '***已脱敏***' });
 
-// 好 - 部分遮罩
-logger.info('卡片已处理', { last_four: '4242' });
+// 好 - 部分脱敏
+logger.info('卡片处理', { last_four: '4242' });
 ```
 
 ### PII 处理
 
-- 盡可能记录使用者 ID 而非電子郵件
-- 对敏感查詢使用雜湊識别码
-- 设置数据保留政策
+- 尽可能记录用户 ID 而非电子邮件
+- 对敏感查询使用哈希标识符
+- 配置数据保留策略
 
-## 错误日誌
+## 错误日志
 
-### 必要的错误欄位
+### 必要字段
 
 ```json
 {
   "level": "ERROR",
-  "message": "数据庫連线失败",
+  "message": "数据库连接失败",
   "error_type": "ConnectionError",
-  "error_message": "連线被拒絕",
+  "error_message": "连接被拒绝",
   "error_code": "ECONNREFUSED",
   "stack": "Error: Connection refused\n    at connect (/app/db.js:45:11)..."
 }
@@ -162,10 +187,10 @@ logger.info('卡片已处理', { last_four: '4242' });
 ### 错误上下文
 
 务必包含：
-- 嘗試的操作是什麼
-- 相关識别码（user_id, request_id）
-- 输入參數（已清理）
-- 重試次數（如適用）
+- 尝试执行的操作是什么
+- 相关标识符（user_id, request_id）
+- 输入参数（已脱敏）
+- 重试次数（如适用）
 
 ```javascript
 logger.error('处理订单失败', {
@@ -178,94 +203,127 @@ logger.error('处理订单失败', {
 });
 ```
 
-## 日誌格式
+## 日志格式
 
-### JSON 格式（生产環境）
+### JSON 格式（生产环境）
 
 ```json
 {"timestamp":"2025-01-15T10:30:00.123Z","level":"INFO","message":"请求完成","request_id":"req_123","duration_ms":45}
 ```
 
-### 人类可读格式（开发環境）
+### 人类可读格式（开发环境）
 
 ```
 2025-01-15T10:30:00.123Z [INFO] 请求完成 request_id=req_123 duration_ms=45
 ```
 
-## 效能考量
+## 性能考量
 
-### 各環境的日誌量
+### 各环境日志量
 
-| 環境 | 层级 | 策略 |
+| 环境 | 级别 | 策略 |
 |------|------|------|
-| 开发 | DEBUG | 所有日誌 |
-| 测试 | INFO | 大部分日誌 |
-| 生产 | INFO | 高流量端点採样 |
+| 开发 | DEBUG | 所有日志 |
+| 预发布 | INFO | 大部分日志 |
+| 生产 | INFO | 高流量端点采样 |
 
 ### 高流量端点
 
-- 使用採样（每 100 筆记录 1 筆）
-- 聚合指標而非个别日誌
-- 使用獨立的日誌串流
+- 使用采样（每 100 条记录 1 条）
+- 聚合指标而非单独日志
+- 使用独立的日志流
+
+## 日志文件轮转
+
+基于文件的日志接收器**必须**同时设置**两个**轮转触发器——基于时间**和**基于大小。常见库（Serilog 1 GB、log4j/Winston/Python `RotatingFileHandler` 无上限）的默认大小上限会导致生产环境中的静默数据丢失。
+
+```
+✓ rollingInterval: Day                    # 基于时间
+✓ fileSizeLimitBytes: 104857600 (100 MB)  # 基于大小
+✓ rollOnFileSizeLimit: true               # 轮转，不丢弃
+✓ retainedFileCountLimit: ≥ N*7           # N = 每天最大轮转次数
+```
+
+当日志文件大小在预计当天结束时达到 **`fileSizeLimitBytes` 的 ≥ 90%**，**先调查噪声根因**（嘈杂的重试循环 / 意外启用的调试日志 / 堆栈跟踪洪流），再提高上限。
+
+> 含各语言（.NET Serilog / Python / Java log4j2 / Node Winston）配置示例及真实事故失败模式参考的完整规范，请参见核心标准中的 [日志文件轮转策略](../../core/logging-standards.md#日志文件轮转策略)。
 
 ## 检查清单
 
-### 必要欄位
+### 必要字段
 
 - [ ] timestamp（ISO 8601）
 - [ ] level
 - [ ] message
-- [ ] service name
+- [ ] 服务名称
 - [ ] request_id 或 trace_id
 
 ### 安全性
 
-- [ ] 没有密码或机密
-- [ ] 没有完整 Token
-- [ ] PII 已遮罩或雜湊
-- [ ] 信用卡從不记录
-- [ ] 保留政策已设置
+- [ ] 无密码或密钥
+- [ ] 无完整令牌
+- [ ] PII 已脱敏或哈希
+- [ ] 信用卡从不记录
+- [ ] 保留策略已配置
+
+### 轮转
+
+- [ ] 已设置时间轮转（`rollingInterval: Day` 或同等配置）
+- [ ] 已设置大小轮转（`fileSizeLimitBytes` + `rollOnFileSizeLimit: true`）
+- [ ] `retainedFileCountLimit` ≥ N×7（N = 每天最大轮转次数）
+- [ ] 已定义 90% 大小 SOP（调查噪声，不要盲目提高上限）
 
 ---
 
-## 设置偵测
+## 配置检测
 
-此技能支援项目特定设置。
+本技能支持项目特定配置。
 
-### 偵测順序
+### 检测顺序
 
-1. 检查現有的日誌程序庫设置
-2. 检查 `CONTRIBUTING.md` 中的日誌指南
-3. 若無找到，**预设使用结构化 JSON 日誌**
+1. 检查现有的日志库配置
+2. 检查 `CONTRIBUTING.md` 中的日志指南
+3. 若未找到，**默认使用结构化 JSON 日志**
 
 ### 首次设置
 
-若未找到日誌标准：
+若未找到日志标准：
 
-1. 建议：「此项目尚未设置日誌标准。您要设置结构化日誌嗎？」
+1. 建议："此项目尚未配置日志标准。是否要设置结构化日志？"
 2. 建议在 `CONTRIBUTING.md` 中记录：
 
 ```markdown
-## 日誌标准
+## 日志标准
 
-### 日誌层级
-- DEBUG: 僅开发環境，详细診斷信息
-- INFO: 正常操作（啟动、使用者操作、任务）
-- WARN: 意外但可恢復的情况
-- ERROR: 需要調查的失败
+### 日志级别
+- DEBUG: 仅开发环境，详细诊断信息
+- INFO: 正常操作（启动、用户操作、任务）
+- WARN: 意外但可恢复的情况
+- ERROR: 需要调查的失败
 
-### 必要欄位
-所有日誌必須包含：timestamp, level, message, service, request_id
+### 必要字段
+所有日志必须包含：timestamp, level, message, service, request_id
 
 ### 敏感数据
-絕不记录：密码、Token、信用卡、身分证字号
+绝不记录：密码、令牌、信用卡、身份证号码
 ```
 
 ---
 
+## 下一步引导
+
+`/logging` 完成后，AI 助手应建议：
+
+> **日志标准已掌握。建议下一步 / Logging standards understood. Suggested next steps:**
+> - 根据日志指南在代码中实现结构化日志 ⭐ **推荐** — 立即将日志标准应用到项目
+> - 执行 `/errors` 设计错误码以配合日志系统 — 让错误追踪更高效
+> - 执行 `/sdd` 将可观测性需求纳入规格 — 确保日志需求在规格中有定义
+
+---
+
 ## 相关标准
 
-- [日誌标准](../../../../core/logging-standards.md)
+- [日志标准](../../../../core/logging-standards.md)
 - [错误码标准](../../../../core/error-code-standards.md)
 
 ---
@@ -274,45 +332,14 @@ logger.error('处理订单失败', {
 
 | 版本 | 日期 | 变更 |
 |------|------|------|
-| 1.0.0 | 2025-12-30 | 初始發布 |
+| 1.4.0 | 2026-06-19 | 新增：强制事件章节（9 个标准事件），消除技能与核心标准之间的内容漂移；版本号与核心日志标准 v1.4.0 对齐（XSPEC-070 Phase 2） |
+| 1.1.0 | 2026-05-26 | 新增：日志文件轮转章节及核心标准轮转策略交叉引用；轮转检查清单（XSPEC-232） |
+| 1.0.0 | 2025-12-30 | 初始发布 |
 
 ---
 
 ## 授权
 
-此技能採用 [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/).
+本技能采用 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 发布。
 
-**Source**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)
+**来源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

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

@@ -187,7 +187,7 @@ AI: Migration Assessment: Vue 2 → Vue 3
 
 ## AI 代理行为
 
-> 完整的 AI 行为定义请参阅对应的命令文件：[`/migrate`](../commands/migrate.md#ai-agent-behavior--ai-代理行为)
+> 完整的 AI 行为定义请参阅对应的命令文件：[`/migrate`](../../../../skills/commands/migrate.md#ai-agent-behavior--ai-代理行為)
 
 ## 授权
 

package/bundled/locales/zh-CN/skills/observability-assistant/guide.md

@@ -14,7 +14,7 @@ description: |
 
 # Observability Assistant
 
-> **语言**：English | [繁体中文](../../locales/zh-TW/skills/observability-assistant/SKILL.md)
+> **语言**: [English](../../../../skills/observability-assistant/guide.md) | 简体中文
 
 **版本**：1.0.0
 **最后更新**：2026-04-01

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

@@ -79,7 +79,7 @@ CREATE ──► REVIEW ──► APPROVE ──► MERGE ──► CLEANUP
 `/pr` 完成后，AI 助手应建议：
 
 > **PR 操作完成。建议下一步：**
-> - 执行 `/review` 进行详细代码审查
+> - 执行 `/code-review` 进行详细代码审查
 > - 执行 `/commit` 修正审查发现的问题
 > - 执行 `/changelog` 更新变更日志
 > - 检查 CI 状态 → `gh pr checks`

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

@@ -305,9 +305,9 @@ routes -> controllers -> services -> repositories -> database
 - 根据现况评估发现编写新功能规格
 - 在风险评估区段引用现况评估报告
 
-### 搭配 /review（代码审查）
+### 搭配 /code-review（代码审查）
 
-步骤 0.4 的快照是 `/review` 的轻量版。在以下情况使用完整的 `/review`：
+步骤 0.4 的快照是 `/code-review` 的轻量版。在以下情况使用完整的 `/code-review`：
 - 现况评估发现重大质量疑虑
 - 规划变更前需要更深入的审计
 

package/bundled/locales/zh-CN/skills/reverse-engineer/SKILL.md

@@ -129,4 +129,4 @@ description: |
 
 ## AI 代理行为
 
-> 完整的 AI 行为定义请参阅对应的命令文件：[`/reverse`](../commands/reverse.md#ai-agent-behavior--ai-代理行为)
+> 完整的 AI 行为定义请参阅对应的命令文件：[`/reverse`](../../../../skills/commands/reverse.md#ai-agent-behavior--ai-代理行為)

package/bundled/locales/zh-CN/skills/runbook-assistant/guide.md

@@ -14,7 +14,7 @@ description: |
 
 # Runbook Assistant
 
-> **语言**：English | [繁體中文](../../locales/zh-TW/skills/runbook-assistant/SKILL.md)
+> **语言**: [English](../../../../skills/runbook-assistant/guide.md) | 简体中文
 
 **版本**：1.0.0
 **最后更新**：2026-04-01

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

@@ -70,7 +70,7 @@ SCOPE ──► SCAN ──► ANALYZE ──► REPORT
 
 > **安全审查完成。建议下一步：**
 > - 执行 `/checkin` 确认修复符合提交规范
-> - 执行 `/review` 进行代码审查
+> - 执行 `/code-review` 进行代码审查
 > - 执行 `/commit` 提交安全修复
 > - 检查依赖包更新 → `npm audit` 或 `pip audit`
 

package/bundled/locales/zh-CN/skills/skill-builder/SKILL.md

@@ -15,7 +15,7 @@ argument-hint: "[process description | 流程描述]"
 
 # 流程转 Skill 助手
 
-> **Language**: English | [繁體中文](../../locales/zh-TW/skills/process-automation/SKILL.md)
+> **语言**: [English](../../../../skills/skill-builder/SKILL.md) | 简体中文
 
 引导你从「我一直在手动做这件事」走到「拥有一个正确构建的 Skill」，并在这一过程中保持适量的流程治理。
 
@@ -144,6 +144,6 @@ Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
 
 ## 参考
 
-- Skill Brief 模板：[templates/SKILL-BRIEF-TEMPLATE.md](../../templates/SKILL-BRIEF-TEMPLATE.md)
-- 候选追踪：[templates/SKILL-CANDIDATES.md](../../templates/SKILL-CANDIDATES.md)（请复制到你的项目）
+- Skill Brief 模板：[templates/SKILL-BRIEF-TEMPLATE.md](../../../../templates/SKILL-BRIEF-TEMPLATE.md)
+- 候选追踪：[templates/SKILL-CANDIDATES.md](../../../../templates/SKILL-CANDIDATES.md)（请复制到你的项目）
 - ADR 标准：[core/adr-standards.md](../../core/adr-standards.md)

package/bundled/locales/zh-CN/skills/slo-assistant/guide.md

@@ -14,7 +14,7 @@ description: |
 
 # SLO Assistant
 
-> **语言**：English | [繁體中文](../../locales/zh-TW/skills/slo-assistant/SKILL.md)
+> **语言**: [English](../../../../skills/slo-assistant/guide.md) | 简体中文
 
 **版本**：1.0.0
 **最后更新**：2026-04-01

package/bundled/locales/zh-CN/skills/spec-derivation/SKILL.md

@@ -83,4 +83,4 @@ disable-model-invocation: true
 
 ## AI 代理行为
 
-> 完整的 AI 行为定义请参阅对应的命令文件：[`/derive`](../../../../skills/commands/derive.md#ai-agent-behavior--ai-代理行为)
+> 完整的 AI 行为定义请参阅对应的命令文件：[`/derive`](../../../../skills/commands/derive.md#ai-agent-behavior--ai-代理行為)

package/bundled/locales/zh-CN/skills/spec-derivation/guide.md

@@ -1,9 +1,9 @@
 ---
 source: ../../../../skills/spec-derivation/guide.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-06-02
-source_hash: 218670e49db0
+source_version: 2.0.0
+translation_version: 2.0.0
+last_synced: 2026-06-10
+source_hash: 3470ae083c12
 status: current
 scope: partial
 description: |
@@ -15,7 +15,7 @@ description: |
 
 # 正向推演指南
 
-> **语言**：English | [繁體中文](../../locales/zh-TW/skills/forward-derivation/SKILL.md)
+> **语言**: [English](../../../../skills/spec-derivation/guide.md) | 简体中文
 
 **版本**：2.0.0
 **最后更新**：2026-01-25
@@ -101,7 +101,7 @@ Scenario: User login with valid credentials
 
 ### 3. 推演标签（来自统一标签系统）
 
-本 skill 使用 **推演标签（Derivation Tags）** 从规格生成新内容。完整的标签参考见 [Anti-Hallucination Standards](../../core/anti-hallucination.md#certainty-classification-tags)。
+本 skill 使用 **推演标签（Derivation Tags）** 从规格生成新内容。完整的标签参考见 [Anti-Hallucination Standards](../../../../core/anti-hallucination.md#certainty-classification-tags)。
 
 | 标签 | 使用时机 | 示例 |
 |-----|----------|---------|
@@ -220,18 +220,17 @@ Scenario: Login shows error for invalid credentials
 # Generator: /derive-bdd v1.0.0
 # Generated at: 2026-01-19T10:00:00Z
 
-@SPEC-001
 Feature: User Authentication
   [Source] From SPEC-001 Summary
 
-  @AC-1 @happy-path
+  @SPEC-001 @AC-1 @happy-path
   Scenario: User login with valid credentials
     # [Source] From SPEC-001 AC-1
     Given a registered user with valid credentials
     When the user submits login form
     Then the user is redirected to dashboard
 
-  @AC-2 @error-handling
+  @SPEC-001 @AC-2 @error-handling
   Scenario: Login fails with invalid credentials
     # [Source] From SPEC-001 AC-2
     Given a user with invalid credentials

package/bundled/locales/zh-CN/skills/spec-driven-dev/SKILL.md

@@ -218,6 +218,6 @@ The system SHALL [behavior description].
 
 ## AI Agent Behavior | AI 代理行为
 
-> 完整的 AI 行为定义请参阅对应的命令文件：[`/sdd`](../commands/sdd.md#ai-agent-behavior--ai-代理行为)
+> 完整的 AI 行为定义请参阅对应的命令文件：[`/sdd`](../../../../skills/commands/sdd.md#ai-agent-behavior--ai-代理行為)
 >
-> For complete AI agent behavior definition, see the corresponding command file: [`/sdd`](../commands/sdd.md#ai-agent-behavior--ai-代理行为)
+> For complete AI agent behavior definition, see the corresponding command file: [`/sdd`](../../../../skills/commands/sdd.md#ai-agent-behavior--ai-代理行為)

package/bundled/locales/zh-CN/skills/sweep/SKILL.md

@@ -125,7 +125,7 @@ sweep:
 `/sweep` 完成后建议：
 
 > - 执行 `/checkin` 在提交前验证整体代码质量
-> - 执行 `/review` 审查清理后的变更
+> - 执行 `/code-review` 审查清理后的变更
 > - 执行 `/commit` 提交修正
 
 ---