universal-dev-standards 5.15.1 → 5.17.0

package/bundled/locales/zh-CN/skills/commands/brainstorm.md

@@ -1,19 +1,20 @@
 ---
 source: ../../../../skills/commands/brainstorm.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-03-19
+source_version: 3.0.0
+source_hash: 3212203924de
+translation_version: 3.0.0
+last_synced: 2026-06-01
 ---
 
 ---
 name: brainstorm
-description: "[UDS] Structured AI-assisted brainstorming before spec creation"
+description: "[UDS] 在编写规格前进行结构化 AI 辅助头脑风暴"
 argument-hint: "[问题或功能构想 | problem or feature idea]"
 ---
 
-# 脑力激荡助手
+# 头脑风暴助手
 
-在撰写规格前进行结构化发想。通过引导式脑力激荡，将模糊构想转化为可执行的功能提案。
+在编写规格前进行结构化发想。通过 persona 集成式头脑风暴，将模糊构想转化为可执行的功能提案。
 
 ## 用法
 
@@ -24,33 +25,37 @@ argument-hint: "[问题或功能构想 | problem or feature idea]"
 ## 工作流程
 
 ```
-FRAME ──► DIVERGE ──► CONVERGE ──► OUTPUT
-定义问题     发散思考       收敛评估       输出提案
+PRE-FLIGHT ──► FRAME ──► DIVERGE ──────────► CONVERGE ─────────► OUTPUT
+  防锚定        定义问题    persona 集成+透镜     多评审面板+硬角色反驳   输出提案
 ```
 
-| 阶段 | 目标 | 关键技法 |
-|------|------|----------|
+| 阶段 | 目标 | 关键技法（v3） |
+|------|------|----------------|
+| **PRE-FLIGHT** | 防止 AI 锚定 | 用户先写 3 个想法；不用类比种子 |
 | **FRAME** | 清楚定义问题 | 5 Whys, HMW, Stakeholder Map |
-| **DIVERGE** | 生成大量想法 | HMW, SCAMPER, Six Thinking Hats |
-| **CONVERGE** | 评估与排序 | Evaluation Matrix, Dot Voting |
-| **OUTPUT** | 可执行的报告 | Brainstorm Report template |
+| **DIVERGE** | 逼出视角多样性 | persona 集成 + 多样性透镜 |
+| **CONVERGE** | 经偏误检查的选择 | 多评审面板 + Devil's Advocate/Steelman |
+| **OUTPUT** | 可执行的报告 | Brainstorm Report 模板 |
 
 ## 技法
 
 | 技法 | 适用场景 |
 |------|----------|
-| **5 Whys** | 找到根本原因 |
-| **HMW** | 将问题重构为机会 |
-| **SCAMPER** | 改善现有功能 |
-| **Six Thinking Hats** | 多角度分析 |
-| **Dot Voting** | 快速排序 |
+| **persona 集成** | 强制视角多样性（v3 核心） |
+| **多样性透镜** | 类比 / 反转 / 形态 |
+| **多评审面板** | 降偏误评分（v3 核心） |
+| **Devil's Advocate + Steelman** | 硬角色反驳 |
+| **5 Whys / HMW / SCAMPER / 六顶帽** | 经典框定与发散 |
 
 ## 范例
 
 ```bash
-/brainstorm                           # Start interactive session
-/brainstorm "user retention"          # Brainstorm around a topic
-/brainstorm --technique scamper       # Use a specific technique
+/brainstorm                                          # Start interactive session
+/brainstorm "user retention"                         # Brainstorm around a topic
+/brainstorm --enhanced "user retention"              # Parallel persona ensemble (if host supports it)
+/brainstorm --personas "designer,economist,skeptic"  # Custom personas
+/brainstorm --lens analogical "onboarding"           # Force the analogical lens
+/brainstorm --quick "reduce checkout friction"       # Fast 3-idea mode
 ```
 
 ## 输出格式
@@ -62,9 +67,10 @@ FRAME ──► DIVERGE ──► CONVERGE ──► OUTPUT
 [Refined problem from FRAME phase]
 
 ## Top 3 Recommendations
-1. **[Idea]** — Score: X.X — [Why recommended]
-2. **[Idea]** — Score: X.X — [Why recommended]
-3. **[Idea]** — Score: X.X — [Why recommended]
+1. **[Idea]** — Agg. X.X ✓ Passed rebuttal — Persona: [..] — [Why recommended]
+
+## Diversity Note
+[How many distinct personas/lenses the surviving ideas span]
 
 ## Next Steps
 - [ ] Proceed to `/requirement` with top idea
@@ -73,15 +79,76 @@ FRAME ──► DIVERGE ──► CONVERGE ──► OUTPUT
 
 ## 后续步骤
 
-脑力激荡后，典型的工作流程是：
+头脑风暴后，典型的工作流程是：
 
 1. `/brainstorm` - 结构化发想（本命令）
 2. `/requirement` - 撰写用户故事和需求
 3. `/sdd` - 创建规格文档
 4. `/derive-all` 或 `/tdd` - 以测试保护进行实现
 
+## AI 代理行为
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### 进入路由
+
+| 输入 | AI 动作 |
+|------|---------|
+| `/brainstorm` | 启动 PRE-FLIGHT，请用户先写 问题＋3 想法＋反向排除 |
+| `/brainstorm "topic"` | 以指定主题启动 PRE-FLIGHT，再进入 FRAME |
+| `/brainstorm --personas "a,b,c"` | 以自定义 persona 组进入 DIVERGE |
+| `/brainstorm --lens <name>` | 以指定多样性透镜为主进入 DIVERGE |
+| `/brainstorm --enhanced` | 若宿主支持子代理则并行跑 persona/评审，否则静默退回 baseline |
+
+### 交互脚本
+
+#### PRE-FLIGHT 阶段
+1. 请用户先写 问题（一句）＋3 个初始想法＋最不想要的解法类型
+2. 拒绝「像 X 但给 Y」种子，改写为底层问题
+
+🛑 **STOP**: 收到三项输入前不生成任何想法（`--skip-preflight` 例外，显示锚定警告）
+
+#### FRAME 阶段
+1. 厘清问题陈述（5 Whys 找根因）
+2. 重构为 HMW 问题；识别利益相关者
+
+🛑 **STOP**: 问题定义后等待用户确认
+
+#### DIVERGE 阶段
+1. 逐一以默认 persona（领域专家／怀疑者／跨域类比者／成本约束者／用户代言）思维链生成想法
+2. **分支隔离**：生成各 persona 时不互相预览，全部产完才一起呈现
+3. 至少套用一个多样性透镜（类比／假设反转／形态矩阵）
+4. 以多样性（覆盖的 persona/透镜数）而非数量为继续门槛
+
+#### CONVERGE 阶段
+1. 以 3 个独立评审（工程可行性／用户影响／战略一致）各自评分后聚合
+2. 对前 3 名跑硬角色 Devil's Advocate（论证会失败）+ Steelman；用户以 (a)修改/(b)反驳/(c)移除 回应
+3. 排序并标记通过反驳的想法
+
+🛑 **STOP**: 展示 Brainstorm Report 后等待用户决定下一步
+
+### 停止点
+
+| 停止点 | 等待内容 |
+|--------|----------|
+| PRE-FLIGHT 提交前 | 收到用户三项输入 |
+| 问题定义后 | 确认问题正确 |
+| 反驳轮每个反对理由 | 用户 (a)/(b)/(c) 回应 |
+| 报告展示后 | 决定进入 `/requirement` 或 `/sdd` |
+
+### 错误处理
+
+| 错误条件 | AI 动作 |
+|----------|---------|
+| 主题太宽泛 | 引导缩小范围 |
+| 使用「像 X 但给 Y」种子 | 改写为底层问题再继续（反种子 guardrail） |
+| 指定的 persona/透镜不存在 | 列出可用选项供选择 |
+| `--enhanced` 但宿主不支持子代理 | 静默退回 baseline，照常进行 |
+| 前 3 名全来自同一 persona/透镜 | 标示并在输出前再跑一个透镜 |
+
 ## 参考
 
 * [Brainstorm Assistant Skill](../brainstorm-assistant/SKILL.md)
+* [Brainstorm Assistant Guide](../brainstorm-assistant/guide.md)
 * [Requirement Assistant](../requirement-assistant/SKILL.md)
 * [Spec-Driven Development](../spec-driven-dev/SKILL.md)

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

@@ -1,11 +1,12 @@
 ---
 source: ../../../../skills/commit-standards/SKILL.md
 source_version: 1.0.0
+source_hash: 8535f438ced8
 translation_version: 1.0.0
-last_synced: 2026-02-10
+last_synced: 2026-06-01
 status: current
 description: |
-  根据 Conventional Commits 规范产生格式正确的 commit message。
+  [UDS] 根据 Conventional Commits 规范产生格式正确的 commit message。
   使用时机：提交代码、撰写 commit message、检查提交格式。
   关键字：commit, conventional commits, 提交, 消息, feat, fix, refactor。
 ---
@@ -18,31 +19,34 @@ description: |
 
 ## 工作流程
 
+0. **检测语言** - 读取 `.standards/manifest.json` → 检查 `options.output_language`。若找不到，默认为 `english`。
 1. **检查状态** - 执行 `git status` 和 `git diff --staged` 了解变更内容
 2. **分析变更** - 判断类型（feat、fix、refactor 等）和范围
-3. **产生消息** - 根据以下格式建立 commit message
+3. **产生消息** - 按检测到的语言，依以下对应格式建立 commit message（见下方）
 4. **确认并提交** - 在执行 `git commit` 前询问用户确认
 
 ### 消息格式
 
 ```
 <type>(<scope>): <subject>
+
 <body>
+
 <footer>
 ```
 
 ## 提交类型
 
-| 类型 | 使用时机 | When to Use |
-|------|---------|-------------|
-| `feat` | 新功能 | New feature |
-| `fix` | 修复错误 | Bug fix |
-| `refactor` | 重构（无功能变更） | Code refactoring |
-| `docs` | 文档更新 | Documentation |
-| `style` | 格式调整（无逻辑变更） | Formatting |
-| `test` | 测试相关 | Tests |
-| `perf` | 性能优化 | Performance |
-| `chore` | 维护任务 | Maintenance |
+| 类型 | 使用时机 |
+|------|---------|
+| `feat` | 新功能 |
+| `fix` | 修复错误 |
+| `refactor` | 重构（无功能变更） |
+| `docs` | 文档更新 |
+| `style` | 格式调整（无逻辑变更） |
+| `test` | 测试相关 |
+| `perf` | 性能优化 |
+| `chore` | 维护任务 |
 
 ## 规则
 
@@ -50,6 +54,60 @@ description: |
 - **Body**：说明**为什么**进行变更，而非仅描述变更了什么
 - **Footer**：使用 `BREAKING CHANGE:` 标记破坏性变更，使用 `Fixes #123` 关联 issue
 
+## 双语格式
+
+当 `output_language` 为 `bilingual` 时，你必须使用以下格式：
+
+```
+<type>(<scope>): <English subject>. <中文主旨>.
+
+<English body — explain what and why in English>
+
+<中文正文 — 用中文说明做了什么及为什么>
+
+<footer>
+```
+
+### 必须遵守的规则
+
+1. 英文正文在前，中文正文在后
+2. 英文正文与中文正文之间以空白行分隔
+3. 严禁在同一段落内混用语言
+4. 严禁省略中文正文——两种语言皆为必填
+5. Footer（BREAKING CHANGE、Fixes #、Co-authored-by）置于两段正文之后的最末端
+
+### 双语示例
+
+```
+feat(auth): Add OAuth2 Google login support. 新增 OAuth2 Google 登录支持.
+
+Implement Google OAuth2 authentication flow for user login.
+
+- Add Google OAuth2 SDK integration
+- Create callback endpoint for OAuth flow
+- Store refresh tokens securely
+
+实现 Google OAuth2 认证流程供用户登录。
+
+- 集成 Google OAuth2 SDK
+- 建立 OAuth 流程回调端点
+- 安全存储刷新令牌
+
+Closes #123
+```
+
+## 繁体中文格式
+
+当 `output_language` 为 `traditional-chinese` 时，使用中文类型与正文：
+
+```
+功能(认证): 新增 OAuth2 Google 登录支持
+
+实现 Google OAuth2 认证流程供用户登录。
+
+关闭 #123
+```
+
 ## 使用方式
 
 - `/commit` - 自动分析 staged 的变更并建议 commit message
@@ -60,11 +118,15 @@ description: |
 `/commit` 完成后，AI 助手应建议：
 
 > **提交完成。建议下一步：**
-> - 执行 `git push` 推送到远端
-> - 准备发布时 → 执行 `/changelog` + `/release`
-> - 发现重复模式或规范摩擦 → 执行 `/audit --report` 回报
+> - 执行 `git push` 推送到远端 ⭐ **推荐** — 推送到远端
+> - 准备发布时 → 执行 `/changelog` + `/release` — 准备发布时执行
+> - 发现重复模式或规范摩擦 → 执行 `/audit --report` 回报 — 检测到模式或摩擦时回报反馈
 
 ## 参考
 
 - 详细指南：[guide.md](./guide.md)
 - 核心规范：[commit-message-guide.md](../../../../core/commit-message-guide.md)
+
+## AI 代理行为
+
+> 完整的 AI 行为定义请参阅对应的命令文件：[`/commit`](../commands/commit.md#ai-agent-behavior--ai-代理行为)

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

@@ -1,20 +1,57 @@
 ---
 source: ../../../../skills/contract-test-assistant/SKILL.md
 source_version: 1.0.0
+source_hash: f67623eb913a
 translation_version: 1.0.0
-last_synced: 2026-03-26
+last_synced: 2026-06-01
 status: current
 description: |
-  引导 API 和微服务的合约测试策略。
-  使用时机：API 合约、微服务、消费者驱动测试。
-  关键字：contract test, Pact, OpenAPI, 合约测试。
+  [UDS] 引导 API 和微服务的契约测试策略。
+  使用时机：API 契约、微服务、消费者驱动测试。
+  关键字：contract test, Pact, OpenAPI, 契约测试。
 ---
 
-# 合约测试助手
+# 契约测试助手
 
 > **语言**: [English](../../../../skills/contract-test-assistant/SKILL.md) | 简体中文
 
-引导 API 和微服务的合约测试策略选择、设置和验证。
+引导 API 和微服务的契约测试策略选择、设置和验证。
+
+## 什么是契约测试？
+
+契约测试通过测试消费者和提供者之间的协议（契约）来验证服务间的通信正确性，不需要所有服务同时运行。
+
+## 策略选择
+
+| 策略 | 适用场景 | 工具 |
+|------|---------|------|
+| **消费者驱动（Consumer-Driven）** | 内部微服务，团队同时拥有两端 | Pact |
+| **提供者驱动（Provider-Driven）** | 公开 API，OpenAPI 优先设计 | OpenAPI + Prism |
+| **双向（Bi-Directional）** | 混合所有权，渐进采用 | Pact + OpenAPI |
+
+## 工作流程
+
+```
+ASSESS ──► CHOOSE ──► DEFINE ──► IMPLEMENT ──► VERIFY
+  评估架构    选择策略    定义契约     实现测试      验证契约
+```
+
+### 1. ASSESS — 评估架构
+- 有多少服务互相通信？
+- 谁拥有消费者端、谁拥有提供者端？
+
+### 2. CHOOSE — 选择策略
+- 消费者驱动（Pact）vs 提供者驱动（OpenAPI）
+
+### 3. DEFINE — 定义契约
+- 编写消费者期望或 OpenAPI 规格
+
+### 4. IMPLEMENT — 实现测试
+- 消费者测试生成契约
+- 提供者测试验证契约
+
+### 5. VERIFY — 执行验证
+- CI 流水线在每个 PR 上验证契约
 
 ## 指令
 
@@ -23,33 +60,55 @@ description: |
 | `/contract-test` | 交互式策略选择 |
 | `/contract-test consumer` | 引导消费者测试设置 |
 | `/contract-test provider` | 引导提供者测试设置 |
-| `/contract-test verify` | 检查合约覆盖率 |
+| `/contract-test verify` | 检查契约覆盖率 |
 
-## 参考
+## 契约覆盖率报告
+
+```markdown
+## 契约覆盖率报告
+
+| 消费者 | 提供者 | 端点 | 状态 |
+|--------|--------|------|------|
+| web-app | user-api | GET /users/:id | ✅ 已验证 |
+| web-app | user-api | POST /users | ✅ 已验证 |
+| mobile-app | auth-api | POST /login | ⚠️ 仅消费者端 |
+| admin-ui | report-api | GET /reports | ❌ 无契约 |
 
-- 详细指南：[contract-testing.md](../../../../options/testing/contract-testing.md)
-- 技能指南：[guide.md](./guide.md)
+**覆盖率**：50%（2/4 个端点两端均验证）
+```
 
+## 与其他技能的集成
 
-## Next Steps Guidance | 下一步引導
+| 技能 | 集成方式 |
+|------|---------|
+| `/api-design` | 设计时定义 API 契约 |
+| `/ci-cd` | 流水线中加入契约验证 |
+| `/testing` | 契约测试作为测试策略一部分 |
+| `/migrate` | API 迁移时捕获 legacy response fixture，验证新实现保持结构性等价 |
 
-After `/contract-test` completes:
+### 迁移契约测试（替换实现时）
 
-> **合約測試引導完成。建議下一步：**
-> - 執行 `/ci-cd` 將合約驗證加入 CI 管線
-> - 執行 `/api-design` 完善 API 設計
-> - 執行 `/testing` 整合到整體測試策略
+当 API endpoint 从一个技术栈迁移至另一个（PHP → .NET、Express → Spring 等），对 **legacy 参考 fixture** 的 contract test 可捕捉「缺失字段」「rename」「层级漂移」等新 DTO 单元测试无法覆盖的缺陷。详见 [migration-assistant § API Migration Contract Tests](../migration-assistant/SKILL.md#api-migration-contract-tests--api-遷移合約測試) 获取 fixture 捕获协议与审计检查清单。
 
-## Reference | 參考
+## 下一步引导
+
+`/contract-test` 完成后：
+
+> **契约测试引导完成。建议下一步：**
+> - 执行 `/ci-cd` 将契约验证加入 CI 流水线
+> - 执行 `/api-design` 完善 API 设计
+> - 执行 `/testing` 集成到整体测试策略
+
+## 参考
 
-- Detailed guide: [contract-testing.md](../../options/testing/contract-testing.md)
-- Related: [api-design-assistant](../api-design-assistant/SKILL.md)
+- 详细指南：[contract-testing.md](../../options/testing/contract-testing.md)
+- 相关：[api-design-assistant](../api-design-assistant/SKILL.md)
 
-## AI Agent Behavior | AI 代理行為
+## 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
+当 `/contract-test` 被调用时：
+1. **评估（Assess）** — 询问架构（单体、微服务、API 数量）
+2. **推荐（Recommend）** — 依架构建议策略
+3. **引导（Guide）** — 逐步引导所选策略的设置
+4. **生成（Generate）** — 创建示例契约测试文件
+5. **验证（Verify）** — 若为 `verify` 子指令，扫描契约并报告覆盖率

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

@@ -0,0 +1,189 @@
+---
+name: deploy
+source: ../../../../skills/deploy-assistant/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-06-02
+source_hash: ff56e7be5b67
+status: current
+scope: universal
+description: |
+  [UDS] 无 CI/CD 平台环境下的可靠部署指引（不依赖 GitHub Actions / GitLab CI）。
+  Use when: deploying to VPS, air-gapped servers, or environments without CI/CD infrastructure.
+  Keywords: deployment, no-cicd, shell script, blue-green, smoke test, rollback, 无CI/CD, 部署.
+allowed-tools: Read, Bash(cat VERSION:*), Bash(git describe:*), Bash(which nginx:*), Bash(which rsync:*)
+argument-hint: "[项目类型: node/python/docker/go]"
+---
+
+# 无 CI/CD 部署助手
+
+> **语言**: [English](../../../../skills/deploy-assistant/SKILL.md) | 简体中文
+
+引导无 CI/CD 平台环境下的可靠部署，采用三层架构：防错、验证、快速恢复。
+
+## 三层部署架构
+
+```
+Layer 1：防止错误部署            Layer 2：验证正确性             Layer 3：快速恢复
+  set -euo pipefail                Smoke Test + /health           Blue-Green 切换
+  版本 tag 强制                    版本号比对                     rollback.sh < 30s
+  deploy.lock 并发守卫             验证失败自动回滚
+```
+
+## 引导式问答
+
+| 问题 | 选项 | 影响 |
+|------|------|------|
+| 项目类型 | node / python / go / docker | 构建命令 |
+| 部署目标 | SSH+rsync / Docker Compose | 传输方式 |
+| Blue-Green 支持 | yes / no | rollback.sh 是否生成 |
+| 健康检查 URL | URL 输入 | verify.sh 目标 |
+| 版本来源 | VERSION 文件 / package.json / git tag | 版本比对逻辑 |
+
+## 生成的脚本组
+
+### deploy.sh — 主要部署脚本
+
+```bash
+#!/usr/bin/env bash
+set -euo pipefail
+
+LOCK_FILE="/tmp/deploy.lock"
+trap "rm -f $LOCK_FILE" EXIT
+
+# 防并发守卫
+if [ -f "$LOCK_FILE" ]; then
+  echo "❌ 已有部署进行中（PID: $(cat $LOCK_FILE)）"
+  exit 1
+fi
+echo $$ > "$LOCK_FILE"
+
+# 版本 tag 强制
+CURRENT_TAG=$(git describe --exact-match --tags HEAD 2>/dev/null || echo "")
+if [ -z "$CURRENT_TAG" ]; then
+  echo "❌ HEAD 没有版本 tag。请执行：git tag vX.Y.Z && git push --tags"
+  exit 1
+fi
+
+echo "[1/4] 执行测试..."
+# {TEST_COMMAND}
+
+echo "[2/4] 构建产物..."
+# {BUILD_COMMAND}
+
+echo "[3/4] 同步至服务器..."
+rsync -avz --delete ./dist/ {USER}@{SERVER}:/app/
+
+echo "[4/4] 验证部署..."
+./verify.sh || { echo "验证失败，启动回滚..."; ./rollback.sh; exit 1; }
+
+echo "{\"timestamp\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"version\":\"$CURRENT_TAG\",\"operator\":\"$(whoami)\",\"result\":\"success\"}" >> /var/log/deployments.jsonl
+echo "✅ 部署成功：$CURRENT_TAG"
+```
+
+### verify.sh — Smoke Test
+
+```bash
+#!/usr/bin/env bash
+set -euo pipefail
+
+HEALTH_URL="${HEALTH_URL:-{HEALTH_URL}}"
+EXPECTED_VERSION=$(cat VERSION)
+
+for i in $(seq 1 3); do
+  RESPONSE=$(curl -sf --max-time 10 "$HEALTH_URL" 2>/dev/null) && break
+  echo "健康检查第 $i/3 次失败，5 秒后重试..."
+  sleep 5
+done
+
+ACTUAL_VERSION=$(echo "$RESPONSE" | python3 -c "import json,sys; print(json.load(sys.stdin)['version'])")
+
+if [ "$ACTUAL_VERSION" != "$EXPECTED_VERSION" ]; then
+  echo "❌ 版本不符！预期 $EXPECTED_VERSION，实际 $ACTUAL_VERSION"
+  exit 1
+fi
+
+echo "✅ 版本验证通过：$ACTUAL_VERSION"
+```
+
+### rollback.sh — Blue-Green 回滚
+
+```bash
+#!/usr/bin/env bash
+set -euo pipefail
+
+CURRENT=$(readlink /app/current 2>/dev/null || echo "/app/blue")
+TARGET=$([[ "$CURRENT" == *"green"* ]] && echo "/app/blue" || echo "/app/green")
+
+ln -sfn "$TARGET" /app/current
+nginx -s reload
+
+echo "✅ 已回滚至 $TARGET ($(date -u +%Y-%m-%dT%H:%M:%SZ))"
+echo "{\"timestamp\":\"$(date -u +%Y-%m-%dT%H:%M:%SZ)\",\"event\":\"rollback\",\"from\":\"$CURRENT\",\"to\":\"$TARGET\",\"operator\":\"$(whoami)\"}" >> /var/log/deployments.jsonl
+```
+
+### Makefile
+
+```makefile
+.PHONY: deploy rollback verify status
+
+deploy:
+	@./deploy.sh
+
+rollback:
+	@./rollback.sh
+
+verify:
+	@./verify.sh
+
+status:
+	@echo "当前 slot：$$(readlink /app/current 2>/dev/null || echo 'N/A')"
+	@curl -s $${HEALTH_URL:-http://localhost/health} | python3 -m json.tool 2>/dev/null || echo "健康检查失败"
+```
+
+## 输出确认清单
+
+脚本生成后，AI 助手必须确认：
+
+- [ ] `deploy.sh` 含 `set -euo pipefail`
+- [ ] `deploy.sh` 含 deploy.lock 并发守卫
+- [ ] `verify.sh` 比对版本号（不只是 HTTP 200）
+- [ ] `rollback.sh` 在 verify 失败时自动触发
+- [ ] `Makefile` 提供 `make deploy / make rollback / make status`
+
+## 使用方式
+
+```bash
+/deploy              # 交互模式 — 自动检测项目类型
+/deploy node         # Node.js 项目，直接生成
+/deploy docker       # Docker Compose 部署模式
+/deploy --verify-only  # 仅生成 verify.sh
+```
+
+## 下一步引导
+
+`/deploy` 完成后，AI 助手应建议：
+
+> **部署脚本已生成，建议下一步：**
+> - `chmod +x deploy.sh verify.sh rollback.sh` — 设置执行权限
+> - `make verify` — 测试健康检查配置
+> - `git tag v1.0.0 && git push --tags` — 创建版本 tag
+> - `make deploy` — 执行第一次部署
+
+## 参考
+
+- 核心标准：[no-cicd-deployment.md](../../../../core/no-cicd-deployment.md)
+- 核心标准：[deployment-standards.md](../../../../core/deployment-standards.md)
+- 核心标准：[deployment-standards.md § Defensive Deployment Ordering](../../../../core/deployment-standards.md#defensive-deployment-ordering) — **强制**遵循 extract-verify-then-delete 顺序
+- 核心标准：[packaging-standards.md § Archive Format Integrity](../../../../core/packaging-standards.md#archive-format-integrity) — 消费 archive 前先验证格式
+- 相关：[ci-cd-assistant](../ci-cd-assistant/SKILL.md) — 适用于有 CI/CD 的环境
+
+## 版本历史
+
+| 版本 | 日期 | 变更说明 |
+|------|------|----------|
+| 1.0.0 | 2026-04-26 | 初始版本 — XSPEC-085 Phase 1b |
+
+## 授权
+
+CC BY 4.0 — 文档内容