universal-dev-standards 5.14.0 → 5.16.0

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

@@ -0,0 +1,242 @@
+---
+name: push
+source: ../../../../skills/push/SKILL.md
+source_version: 2.0.0
+translation_version: 2.0.0
+last_synced: 2026-06-02
+source_hash: b7812535483c
+scope: universal
+description: |
+  [UDS] AI 辅助 git push 安全层：质量门禁 + 协作护栏。
+  Use when: pushing commits, force pushing, pushing to protected branches, pushing feature branches.
+  Keywords: git push, force push, protected branch, quality gate, push receipt, PR automation, 推送, 保护分支, 质量门禁.
+allowed-tools: Read, Bash(git:*), Bash(npm:*), Bash(pnpm:*), Bash(yarn:*), Bash(bun:*)
+argument-hint: "[--force] [--target <branch>] [--skip-gates] [--no-pr]"
+---
+
+# 推送助手
+
+> **语言**: [English](../../../../skills/push/SKILL.md) | 简体中文
+
+**版本**：2.0.0
+**创建日期**：2026-04-23
+**适用范围**：Claude Code Skills
+
+---
+
+`git push` 的 AI 辅助安全层。检测保护分支、强制 force-push 护栏、执行 pre-push 质量门禁、输出结构化推送收据，并集成 PR 自动化。
+
+## 核心标准
+
+本 Skill 实现 [`.standards/push-standards.ai.yaml`](../../../../.standards/push-standards.ai.yaml)。
+
+---
+
+## 执行工作流程
+
+调用 `/push` 后，Claude 原生依序执行以下步骤：
+
+### Step 1：检测保护分支
+执行 `git rev-parse --abbrev-ref HEAD` 获取当前分支。
+比对 `protected_branches` 列表（默认：main、master、release/*、hotfix/*）。
+若为保护分支：显示警告 + 待推送的 commit 列表，需用户明确确认才能继续。
+
+### Step 2：检测 Force Push
+若检测到 `--force` 或 `--force-with-lease`：
+执行 `git log origin/<branch>..HEAD --oneline` 找出将被覆盖的 commits。
+显示数量与作者列表。需要用户输入 `yes, force push` 才能继续。
+
+### Step 3：执行 Pre-Push 质量门禁
+依序使用 Bash tool 执行每个已设置的门禁：
+- `lint`：检测并执行项目 lint 命令
+- `test`：检测并执行项目测试命令
+- `type-check`（可选）：TypeScript 类型检查
+- `ac-coverage`（可选）：验收条件覆盖率
+- `security-scan`（可选）：安全漏洞扫描
+
+若任何必需门禁失败：中止并显示错误信息。
+
+### Step 4：执行推送
+执行 `git push <remote> <branch> [--force]`。
+若推送失败：显示 git 错误并建议修正方式。
+
+### Step 5：发出推送收据
+将结构化收据输出到 console（可选择写入 `~/.uds/push-history.jsonl`）：
+```json
+{
+  "branch": "<branch>",
+  "commit_sha": "<sha>",
+  "gates_passed": ["lint", "test"],
+  "force_push": false,
+  "timestamp": "<ISO8601>",
+  "target_remote": "origin"
+}
+```
+
+### Step 6：PR 集成
+若 `auto_pr=true` **且** `repo_mode=team` **且**该分支无 open PR：
+建议用户执行 `/pr-automation-assistant` 创建 Pull Request。
+
+---
+
+## 功能说明
+
+### 1. 推送目标风险检测
+
+推送前检测目标分支是否为保护分支（例如 `main`、`master`、`release/*`、`hotfix/*`）。
+
+- 显示**警告**，列出分支名称与 commit 列表
+- 需要用户明确确认才能继续
+- 用户未确认则中止推送
+
+### 2. Force-Push 护栏
+
+检测到 `--force` 时，推送前显示影响范围。
+
+- 计算远端将被覆盖的 commits
+- 显示被覆盖 commits 的数量与作者
+- 要求用户输入确认字符串（`yes, force push`）
+- 在推送收据中记录 `force_push: true`
+
+### 3. Pre-Push 质量门禁
+
+推送前依序执行已设置的质量门禁。
+
+| 门禁 | 说明 |
+|------|------|
+| `lint` | 执行 lint 检查 |
+| `test` | 执行测试 |
+| `type-check` | TypeScript 类型检查（可选） |
+| `ac-coverage` | AC 覆盖率检查（可选） |
+| `security-scan` | 安全扫描（可选） |
+
+### 4. 推送收据
+
+推送成功后输出结构化收据，供审计追踪使用。
+
+```json
+{
+  "branch": "feature/my-feature",
+  "commit_sha": "a1b2c3d",
+  "gates_passed": ["lint", "test"],
+  "gates_skipped": false,
+  "force_push": false,
+  "timestamp": "2026-04-23T10:00:00Z",
+  "target_remote": "origin"
+}
+```
+
+可选择追加到 `~/.uds/push-history.jsonl` 以持久化审计追踪。
+
+### 5. PR 自动化集成入口
+
+推送 feature branch 后，若尚无 PR，提示用户创建 Pull Request。
+
+- 检查该分支是否已有 open PR
+- 提示用户执行 `pr-automation-assistant`
+- 在 `single-owner` repo 模式或使用 `--no-pr` 旗标时跳过
+
+---
+
+## 使用方式
+
+```bash
+# 标准推送（自动执行质量门禁）
+/push
+
+# Force push（显示被覆盖 commits，需要确认）
+/push --force
+
+# 推送到指定的远端分支
+/push --target main
+
+# 跳过质量门禁（紧急情况）
+/push --skip-gates
+
+# 推送但不提示创建 PR
+/push --no-pr
+
+# Force push 且不提示创建 PR（例如更新个人分支）
+/push --force --no-pr
+```
+
+## 参数说明
+
+| 参数 | 说明 |
+|------|------|
+| `--force` | 启用 force push，含护栏确认 |
+| `--target <branch>` | 明确指定目标远端分支 |
+| `--skip-gates` | 跳过质量门禁（仅紧急情况） |
+| `--no-pr` | 推送后不提示创建 PR |
+
+---
+
+## 设置
+
+通过 `uds.project.yaml` 设置：
+
+```yaml
+push:
+  repo_mode: team           # "team" | "single-owner"
+  protected_branches:
+    - main
+    - master
+    - "release/*"
+    - "hotfix/*"
+  push_gates:
+    default:
+      - lint
+      - test
+    optional:
+      - type-check
+      - ac-coverage
+      - security-scan
+  receipt:
+    output: console          # "console" | "file" | "both"
+    file_path: "~/.uds/push-history.jsonl"
+  auto_pr: true              # 推送到非保护分支后是否提示创建 PR
+```
+
+### 选项模式
+
+| Option 文件 | 模式 | 说明 |
+|-------------|------|------|
+| [`options/push/team-mode.md`](../../../../options/push/team-mode.md) | `team` | 完整协作护栏（默认） |
+| [`options/push/single-owner-mode.md`](../../../../options/push/single-owner-mode.md) | `single-owner` | 个人 repo 低摩擦模式 |
+
+---
+
+## 下一步引导
+
+`/push` 完成后，AI 助手应建议：
+
+> **推送完成。建议下一步：**
+> - 执行 `/pr-automation-assistant` 创建或更新 Pull Request ⭐ **推荐** — 确保协作流程完整
+> - 执行 `/checkin` 确认代码签入质量 — 下次提交前的质量确认
+> - 查看 `~/.uds/push-history.jsonl` 确认推送记录 — 审计追踪
+
+---
+
+## 相关标准
+
+- [Push Standards](../../../../.standards/push-standards.ai.yaml) — 核心推送安全规则
+- [Git Workflow](../../../../.standards/git-workflow.ai.yaml) — 分支策略
+- [Commit Message](../../../../.standards/commit-message.ai.yaml) — Commit 约定
+- [PR Automation](../pr-automation-assistant/SKILL.md) — Pull Request 自动化
+
+---
+
+## 版本历程
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 2.0.0 | 2026-04-28 | 还原 workflow 执行步骤（XSPEC-097 采用层解耦）；移除弃用通知 |
+| 1.0.0 | 2026-04-23 | 初始版本 — XSPEC-081 Phase 1 |
+
+---
+
+## 授权
+
+本 Skill 采用 [MIT License](https://opensource.org/licenses/MIT) 与 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 双重授权发布。
+
+**来源**：[universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)

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

@@ -1,68 +1,136 @@
 ---
 source: ../../../../skills/retrospective-assistant/SKILL.md
 source_version: 1.0.0
+source_hash: 9c883f05ad7b
 translation_version: 1.0.0
-last_synced: 2026-03-26
+last_synced: 2026-06-01
 status: current
 description: |
-  引导结构化的团队回顾，支持 Sprint 和 Release 回顾。
-  使用时机：迭代结束、发布后、流程改善。
-  关键字：retrospective, retro, 回顾, 检讨, 持续改善。
+  [UDS] 引导 Sprint 与 Release 周期的结构化团队回顾。
+  使用时机：迭代结束、发布复盘、流程改善。
+  关键字：retrospective, retro, 回顾, 复盘, 持续改善。
 ---
 
 # 回顾助手
 
 > **语言**: [English](../../../../skills/retrospective-assistant/SKILL.md) | 简体中文
 
-引导结构化的团队回顾，识别改善机会并追踪行动项目。
+引导结构化的团队回顾，识别改善机会并追踪行动项目。支持 Sprint 和 Release 回顾类型，提供多种引导技法。
+
+## 工作流程
+
+```
+PREPARE ──► GATHER ──► ANALYZE ──► DECIDE ──► TRACK
+  准备数据    搜集意见    分析归纳    决定行动    追踪落实
+```
+
+### 阶段 1：PREPARE（准备）
+
+从 git log、指标和 issue tracker 搜集数据作为讨论基础。
+
+### 阶段 2：GATHER（搜集）
+
+使用结构化技法搜集团队观点。
+
+### 阶段 3：ANALYZE（分析）
+
+分组归纳并识别模式。
+
+### 阶段 4：DECIDE（决定）
+
+选出前 1-3 项改善作为行动项目。
+
+### 阶段 5：TRACK（追踪）
+
+回顾过去的行动项目并追踪新项目。
+
+## 回顾类型
+
+| 类型 | 时机 | 时长 | 焦点 |
+|------|------|------|------|
+| **Sprint** | 迭代结束 | 30-60 分钟 | 流程、协作、工具 |
+| **Release** | 发布之后 | 60-90 分钟 | 质量、指标、跨团队 |
+
+## 引导技法
+
+| 技法 | 适用场景 | 结构 |
+|------|---------|------|
+| **Start-Stop-Continue** | 快速、默认 | 开始 / 停止 / 继续 |
+| **Starfish** | 细致分析 | 更多 / 保持 / 减少 / 开始 / 停止 |
+| **4Ls** | 团队建设 | 喜欢 / 学到 / 缺少 / 渴望 |
+| **Sailboat** | 可视化、创意 | 风 / 锚 / 礁石 / 岛屿 |
 
 ## 指令
 
 | 指令 | 说明 |
 |------|------|
-| `/retrospective` | 交互式 Sprint 回顾 |
+| `/retrospective` | 交互式 Sprint 回顾（默认） |
+| `/retrospective sprint` | Sprint 回顾 |
 | `/retrospective release` | Release 回顾（含指标） |
 | `/retrospective actions` | 列出未完成行动项目 |
+| `/retrospective --technique starfish` | 使用指定技法 |
 
-## 参考
+## 行动项目格式
 
-- 核心规范：[retrospective-standards.md](../../../../core/retrospective-standards.md)
-- 详细指南：[guide.md](./guide.md)
+| 字段 | 说明 |
+|------|------|
+| **Action** | 具体描述 |
+| **Owner** | 单一负责人 |
+| **Due Date** | 预计完成日 |
+| **Status** | Open → In Progress → Done |
 
+### 追踪规则
 
-## Next Steps Guidance | 下一步引導
+1. 每次回顾**开始**先查看未完成项目
+2. 每次回顾最多 **3 项**行动项目
+3. 陈旧项目（超过 2 个周期未完成）须重新评估
+4. 每项须有**单一负责人**
 
-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
+```
+docs/retrospectives/
+├── RETRO-2026-03-15-sprint-12.md
+├── RETRO-2026-03-26-release-v5.1.0.md
+└── README.md    # 索引（可选）
+```
 
-> **回顧完成。建議下一步：**
-> - 提交回顧報告：`/commit`
-> - 為識別的架構決策建立 ADR：`/adr`
-> - 在 issue tracker 中追蹤行動項目
-> - 排定下次回顧
+## 与其他技能的集成
 
-## AI Agent Behavior | AI 代理行為
+| 技能 | 集成方式 |
+|------|---------|
+| `/metrics` | 将指标数据引入 Release 回顾 |
+| `/incident` | 事故后建议进行团队回顾 |
+| `/adr` | 识别架构问题时建议建立 ADR |
+| `/commit` | 以 `docs(retro):` 提交回顾报告 |
 
-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
+`/retrospective` 完成后：
 
-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
+> **回顾完成。建议下一步：**
+> - 提交回顾报告：`/commit`
+> - 为识别的架构决策建立 ADR：`/adr`
+> - 在 issue tracker 中追踪行动项目
+> - 排定下次回顾
 
-## Reference | 參考
+## AI 代理行为
 
-- Core Standard: [retrospective-standards.md](../../core/retrospective-standards.md)
-- Detailed Guide: [guide.md](./guide.md)
+当调用 `/retrospective` 时：
+
+1. **确认类型** — Sprint（默认）或 Release
+2. **搜集数据** — 扫描 git log，检查 `docs/retrospectives/` 中过去的行动项目
+3. **引导技法** — 默认使用 Start-Stop-Continue，或使用指定技法
+4. **生成报告** — 写入 `docs/retrospectives/RETRO-YYYY-MM-DD-[type].md`
+5. **查看过去项目** — 检查先前回顾中未完成的行动项目
+6. **提供下一步** — 显示上方引导
+
+当调用 `/retrospective actions` 时：
+1. 扫描 `docs/retrospectives/` 中所有回顾文件
+2. 解析各文件中的行动项目
+3. 以表格显示未完成／进行中的项目
+
+## 参考
+
+- 核心规范：[retrospective-standards.md](../../core/retrospective-standards.md)
+- 详细指南：[guide.md](./guide.md)

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

@@ -1,76 +1,132 @@
 ---
 source: ../../../../skills/reverse-engineer/SKILL.md
 source_version: 1.2.0
+source_hash: d543b24b2422
 translation_version: 1.2.0
-last_synced: 2026-02-10
+last_synced: 2026-06-01
 status: current
 description: |
-  将现有代码反向工程为规格文件、BDD 场景或 TDD 覆盖率报告。
-  使用时机：从代码提取规格、生成 Gherkin 场景、分析测试覆盖率。
-  关键字：reverse engineering, spec, bdd, tdd, 反向工程, 规格, 覆盖率。
+  系统考古——跨逻辑、数据、运行时三维度逆向工程代码。
+  使用时机：从代码提取规格、分析数据模型、分析运行时基准、生成 Gherkin 场景、分析测试覆盖率。
+  关键字：reverse engineering, spec, data, runtime, bdd, tdd, 逆向工程, 规格, 覆盖率。
 ---
 
-# 反向工程助手
+# 逆向工程助手
 
 > **语言**: [English](../../../../skills/reverse-engineer/SKILL.md) | 简体中文
 
-将现有代码反向工程为规格文件、BDD 场景或 TDD 覆盖率报告。
+系统考古框架：从三个维度逆向工程既有系统——**逻辑**、**数据**、**运行时**。
+
+## 三大维度
+
+```
+┌─────────────────────────────────────────────────────────┐
+│              System Archeology Framework                   │
+├──────────┬──────────────┬────────────────────────────────┤
+│  Logic   │     Data     │          Runtime               │
+│ (spec)   │    (data)    │         (runtime)              │
+├──────────┼──────────────┼────────────────────────────────┤
+│ APIs     │ DB Schemas   │ Logs & Error Patterns          │
+│ Modules  │ ORMs/Models  │ Config & Environment           │
+│ Flows    │ Migrations   │ Metrics & Performance          │
+│ Tests    │ Seed Data    │ Infra & Deployment             │
+└──────────┴──────────────┴────────────────────────────────┘
+```
 
 ## 子命令
 
-| 子命令 | 输入 | 输出 | 说明 |
-|--------|------|------|------|
-| `spec` | 代码文件/目录 | `SPEC-XXX.md` | 从代码提取规格 |
-| `bdd` | `SPEC-XXX.md` | `.feature` | 将 AC 转为 Gherkin |
-| `tdd` | `.feature` | 覆盖率报告 | 分析测试覆盖率 |
+| 子命令 | 维度 | 输入 | 输出 | 说明 |
+|--------|------|------|------|------|
+| *(无)* | 全部 | 项目根目录 | 完整考古报告 | 三维度全面分析 |
+| `spec` | 逻辑 | 代码文件/目录 | `SPEC-XXX.md` | 从代码提取规格 |
+| `data` | 数据 | DB 结构、ORM、迁移文件 | 数据模型规格 | 分析数据模型与结构 |
+| `runtime` | 运行时 | 日志、配置、指标 | 运行时基准 | 分析运行时基准 |
+| `bdd` | — | `SPEC-XXX.md` | `.feature` | 将 AC 转为 Gherkin |
+| `tdd` | — | `.feature` | 覆盖率报告 | 分析测试覆盖率 |
+
+## 全面分析模式
+
+当 `/reverse` 在未带子命令的情况下被调用时，依序执行全部三个维度：
+
+1. **数据（Data）** → 扫描结构、ORM、迁移文件
+2. **运行时（Runtime）** → 分析日志、配置、部署
+3. **逻辑（Logic / spec）** → 提取 API、流程、测试 → 生成 SPEC
+
+输出：整合三个维度的 **系统考古报告（System Archeology Report）**。
 
-## 工作流程
+## 维度详情
 
-### spec：代码转规格
+### spec：逻辑维度（既有）
 
-1. **扫描** - 读取源代码文件，识别公开 API、数据流和业务逻辑
+1. **扫描** - 读取源代码文件，识别公开 API、数据流与业务逻辑
 2. **分类** - 将每个发现标记为 `[Confirmed]`、`[Inferred]` 或 `[Unknown]`
 3. **结构化** - 整理为 SDD 规格格式，包含验收条件
-4. **引用来源** - 每个反向结果皆引用 `file:line` 来源参考
+4. **引用来源** - 每项逆向结果皆以 `file:line` 引用来源
 
-### bdd：规格转 Gherkin
+### data：数据维度（新增）
 
-1. **解析** - 读取 SPEC-XXX.md 并提取验收条件
-2. **转换** - 将每个 AC 对应为一个 Gherkin Scenario（1:1 对应）
-3. **标记** - 加入 `@SPEC-XXX` 和 `@AC-N` 标签以确保可追溯性
-4. **输出** - 生成 `.feature` 文件，包含 `# [Source: path:AC-N]` 注释
+1. **探索** - 找出数据库结构、ORM 模型、迁移文件、种子数据
+2. **映射** - 从代码证据建立实体关联模型
+3. **分类** - 将关联标记为 `[Confirmed]`（FK 约束）或 `[Inferred]`（代码模式）
+4. **报告** - 输出数据模型规格，包含：
+   - 含字段与类型的实体清单
+   - 关联映射（1:1、1:N、M:N）
+   - 索引与约束清单
+   - 迁移历史摘要
+   - 数据流路径（写入 → 读取）
 
-### tdd：Feature 转覆盖率报告
+**证据来源**：`schema.prisma`、`*.migration.*`、`models/`、`entities/`、`knexfile.*`、`sequelize`、`typeorm`、SQL 文件、`docker-compose.yml`（DB 服务）
 
-1. **解析** - 读取 `.feature` 文件中的场景
-2. **搜索** - 使用 Grep/Glob 寻找对应的测试文件
-3. **对应** - 将场景与现有单元测试进行配对
-4. **报告** - 输出覆盖率矩阵（已覆盖 / 缺失 / 部分覆盖）
+### runtime：运行时维度（新增）
+
+1. **扫描配置** - 环境变量、配置文件、功能开关
+2. **分析日志** - 日志模式、错误频率、日志级别
+3. **检查基础设施** - Docker 配置、CI/CD 流水线、部署清单
+4. **建立基准** - 输出运行时基准，包含：
+   - 环境变量清单（仅名称，**绝不含值/密钥**）
+   - 配置文件映射与层级
+   - 外部服务依赖（API、队列、缓存）
+   - 部署拓扑（容器、服务）
+   - 健康检查与监控端点
+
+**证据来源**：`.env.example`、`docker-compose.yml`、`Dockerfile`、`*.config.*`、CI/CD 文件、`k8s/`、日志文件（仅模式）
+
+**安全性**：绝不输出实际密钥值。仅列出变量名称并描述其用途。
 
 ## 防幻觉规则
 
 | 规则 | 要求 |
 |------|------|
 | **确定性标签** | 所有发现须使用 `[Confirmed]`、`[Inferred]`、`[Unknown]` 标注 |
-| **来源引用** | 每项反向结果须引用 `file:line` 来源 |
+| **来源引用** | 每项逆向结果须引用 `file:line` 来源 |
 | **禁止捏造** | 不得捏造代码中不存在的 API 或行为 |
+| **禁止密钥** | 不得输出配置文件或环境变量的密钥值 |
 
 ## 使用方式
 
-- `/reverse spec src/auth/` - 从 auth 模块提取规格
-- `/reverse bdd specs/SPEC-AUTH.md` - 将规格 AC 转为 Gherkin 场景
-- `/reverse tdd features/auth.feature` - 分析 feature 文件的测试覆盖率
+```
+/reverse                              - 三维度全面分析
+/reverse spec src/auth/               - 逻辑：提取规格
+/reverse data                         - 数据：分析结构与模型
+/reverse runtime                      - 运行时：分析配置与基础设施
+/reverse bdd specs/SPEC-AUTH.md       - 将规格 AC 转为 Gherkin
+/reverse tdd features/auth.feature    - 分析测试覆盖率
+```
 
 ## 下一步引导
 
 `/reverse`（完整或 `spec`）完成后，AI 助手应建议：
 
 > **系统考古完成。建议下一步：**
-> - 执行 `/sdd` 审查并核准此规格
-> - 执行 `/derive` 从规格推导测试
-> - 审查规格中的 `[Inferred]` 和 `[Unknown]` 标记
+> - 执行 `/sdd` 审查并核准此规格 ⭐ **推荐** — 审查并核准生成的规格
+> - 执行 `/derive` 从规格推导测试 — 从规格推导测试（须先核准）
+> - 审查规格中的 `[Inferred]` 和 `[Unknown]` 标记 — 手动审查不确定性标签
 
 ## 参考
 
 - 详细指南：[guide.md](./guide.md)
 - 核心规范：[reverse-engineering-standards.md](../../../../core/reverse-engineering-standards.md)
+
+## AI 代理行为
+
+> 完整的 AI 行为定义请参阅对应的命令文件：[`/reverse`](../commands/reverse.md#ai-agent-behavior--ai-代理行为)