universal-dev-standards 5.0.0-rc.8 → 5.0.0

package/bundled/locales/zh-CN/skills/commands/reverse-sdd.md

@@ -0,0 +1,51 @@
+---
+description: [UDS] Reverse engineer code into SDD specification document
+allowed-tools: Read, Grep, Glob, Write
+argument-hint: "[source file or directory | 源文件或目录]"
+---
+
+# /reverse-sdd — Reverse Engineer to SDD Spec | 逆向工程为 SDD 规格
+
+Reverse engineer existing code into a structured SDD specification document.
+
+将现有代码逆向工程为结构化的 SDD 规格文件。
+
+## Workflow | 工作流程
+
+```
+Source Code ──► Analyze ──► Extract Requirements ──► Generate SPEC-XXX.md
+```
+
+1. **扫描**源代码结构和依赖关系
+2. **提取**隐含需求、API 契约、业务规则
+3. **分类**每项发现的确定性：`[Confirmed]`、`[Inferred]`、`[Assumption]`
+4. **生成** SDD 合规的规格文件
+5. **审查**生成的规格以确保准确性
+
+## Output Format | 输出格式
+
+```markdown
+# [SPEC-XXX] Feature: [Reverse-Engineered Name]
+
+## Overview
+[Inferred] Based on analysis of src/auth/...
+
+## Requirements
+- REQ-001: [Confirmed] User authentication via OAuth2
+- REQ-002: [Inferred] Session timeout after 30 minutes
+
+## Acceptance Criteria
+- AC-1: [Confirmed] Given valid credentials, when login, then session created
+```
+
+## Usage | 使用方式
+
+| Command | Purpose | 用途 |
+|---------|---------|------|
+| `/reverse-sdd src/auth/` | Reverse engineer auth module | 逆向工程 auth 模块 |
+| `/reverse-sdd` | Interactive — ask for target | 交互式 — 询问目标 |
+
+## Reference | 参考
+
+- Parent command: [/reverse](../reverse-engineer/SKILL.md)
+- Core standard: [reverse-engineering-standards.md](../../core/reverse-engineering-standards.md)

package/bundled/locales/zh-CN/skills/commands/reverse-tdd.md

@@ -0,0 +1,51 @@
+---
+description: [UDS] Analyze BDD-TDD coverage gaps
+allowed-tools: Read, Grep, Glob, Write
+argument-hint: "[feature file or test directory | Feature 文件或测试目录]"
+---
+
+# /reverse-tdd — Analyze BDD-TDD Coverage Gaps | 分析 BDD-TDD 覆盖差距
+
+Analyze gaps between BDD scenarios and TDD test coverage.
+
+分析 BDD 场景与 TDD 测试覆盖之间的差距。
+
+## Workflow | 工作流程
+
+```
+.feature + tests/ ──► Map Scenarios ──► Find Gaps ──► Report
+```
+
+1. **解析**现有 `.feature` 文件中的场景
+2. **扫描**测试文件中对应的单元测试
+3. **映射** BDD 场景到 TDD 测试覆盖
+4. **识别**覆盖差距（没有单元测试的场景）
+5. **生成**差距报告及建议
+
+## Output Format | 输出格式
+
+```markdown
+# BDD-TDD Coverage Gap Analysis
+
+## Coverage Summary
+- Total BDD Scenarios: 12
+- Covered by TDD: 9 (75%)
+- Gaps Found: 3
+
+## Gaps
+| Scenario | Feature File | Missing TDD |
+|----------|-------------|-------------|
+| Password reset | auth.feature:15 | No unit test for token validation |
+```
+
+## Usage | 使用方式
+
+| Command | Purpose | 用途 |
+|---------|---------|------|
+| `/reverse-tdd features/` | Analyze all feature files | 分析所有 feature 文件 |
+| `/reverse-tdd features/auth.feature` | Analyze specific feature | 分析特定 feature |
+
+## Reference | 参考
+
+- Parent command: [/reverse](../reverse-engineer/SKILL.md)
+- Core standard: [reverse-engineering-standards.md](../../core/reverse-engineering-standards.md)

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

@@ -0,0 +1,63 @@
+---
+name: reverse
+description: [UDS] Reverse engineer code to Specs, BDD, or TDD coverage.
+argument-hint: "[spec|bdd|tdd] <input> [--output <file>]"
+---
+
+# Reverse Engineering | 逆向工程
+
+Reverse engineer existing code or tests into specifications and scenarios.
+
+将现有代码或测试逆向工程为规格和场景。
+
+## Usage | 用法
+
+```bash
+/reverse [subcommand] <input> [options]
+```
+
+### Subcommands | 子命令
+
+| Subcommand | Input | Output | Description |
+|------------|-------|--------|-------------|
+| `spec` | Code files/dirs | `SPEC-XXX.md` | 从代码创建 SDD 规格 |
+| `bdd` | `SPEC-XXX.md` | `.feature` | 将规格 AC 转换为 Gherkin |
+| `tdd` | `.feature` | Coverage Report | 分析 feature 的 TDD 覆盖 |
+
+### Options | 选项
+
+| Option | Description |
+|--------|-------------|
+| `--output` | 输出文件路径 |
+| `--include-tests` | 分析中包含测试文件（用于 `spec`） |
+| `--review` | 生成后触发审查 |
+
+## Workflows | 工作流程
+
+### 1. Code to Spec (Legacy Recovery)
+```bash
+/reverse spec src/auth/ --output specs/SPEC-AUTH.md
+```
+分析代码逻辑以创建功能规格。
+
+### 2. Spec to BDD (Scenario Generation)
+```bash
+/reverse bdd specs/SPEC-AUTH.md --output features/auth.feature
+```
+将规格中的验收标准转换为 Gherkin 场景。
+
+### 3. BDD to TDD (Coverage Analysis)
+```bash
+/reverse tdd features/auth.feature
+```
+检查 feature 文件中的场景是否有对应的单元测试。
+
+## Anti-Hallucination | 防幻觉
+
+*   **确定性标签**：在输出中使用 `[Confirmed]`、`[Inferred]`、`[Unknown]` 标签。
+*   **来源归因**：为所有逆向逻辑引用 `file:line`。
+
+## References | 参考
+
+*   [Reverse Engineering Skill](../reverse-engineer/SKILL.md)
+*   [Core Standard](../../core/reverse-engineering-standards.md)

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

@@ -0,0 +1,50 @@
+---
+description: [UDS] Perform systematic code review with checklist
+allowed-tools: Read, Grep, Glob, Bash(git diff:*), Bash(git log:*), Bash(git show:*)
+argument-hint: "[file path or branch | 文件路径或分支名称]"
+---
+
+# Code Review Assistant | 代码审查助手
+
+Perform systematic code review using standardized checklists and comment prefixes.
+
+执行系统性的代码审查，使用标准化的检查清单和评论前缀。
+
+## Workflow | 工作流程
+
+1. **识别变更** - 获取待审查文件的 diff
+2. **应用检查清单** - 系统性地检查每个类别
+3. **生成报告** - 使用标准前缀输出发现
+4. **总结** - 提供整体评估
+
+## Review Categories | 审查类别
+
+1. **功能性** - 是否正确运行？
+2. **设计** - 架构是否合适？
+3. **质量** - 代码是否整洁、可维护？
+4. **可读性** - 是否易于理解？
+5. **测试** - 是否有足够的测试覆盖？
+6. **安全性** - 是否有漏洞？
+7. **性能** - 是否高效？
+8. **错误处理** - 是否正确处理错误？
+
+## Comment Prefixes | 评论前缀
+
+| Prefix | Meaning | Action |
+|--------|---------|--------|
+| **BLOCKING** | 必须在合并前修复 | 必需 |
+| **IMPORTANT** | 应该修复 | 建议 |
+| **SUGGESTION** | 锦上添花 | 可选 |
+| **QUESTION** | 需要澄清 | 讨论 |
+| **NOTE** | 信息性说明 | 仅供参考 |
+
+## Usage | 使用方式
+
+- `/review` - 审查当前分支的所有变更
+- `/review src/auth.js` - 审查特定文件
+- `/review feature/login` - 审查特定分支
+
+## Reference | 参考
+
+- Full standard: [code-review-assistant](../code-review-assistant/SKILL.md)
+- Core guide: [code-review-checklist](../../core/code-review-checklist.md)

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

@@ -0,0 +1,76 @@
+---
+source: ../../../../skills/commands/scan.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-03-25
+status: current
+---
+
+---
+description: "[UDS] Guide automated security scanning, dependency auditing and secret detection"
+allowed-tools: Read, Grep, Glob, Bash(npm:audit, npx:*)
+argument-hint: "[scan type or target | 扫描类型或目标]"
+---
+
+# Security Scan Assistant | 安全扫描助手
+
+Guide automated security scanning, dependency auditing and secret detection.
+
+引导自动化安全扫描、依赖包审计和机密检测。
+
+## Workflow | 工作流程
+
+```
+SCAN ──► TRIAGE ──► PRIORITIZE ──► FIX ──► VERIFY
+```
+
+## Usage | 使用方式
+
+- `/scan` - 执行所有安全扫描
+- `/scan --deps` - 依赖漏洞扫描
+- `/scan --secrets` - 机密检测扫描
+- `/scan --license` - 许可证合规检查
+
+## AI Agent Behavior | AI 代理行为
+
+> 遵循 [AI Command Behavior Standards](../../core/ai-command-behavior.md)
+
+### Entry Router | 进入路由
+
+| 输入 | AI 动作 |
+|------|---------|
+| `/scan` | 执行所有扫描类型 |
+| `/scan --deps` | 仅执行依赖包漏洞扫描 |
+| `/scan --secrets` | 仅执行机密检测 |
+| `/scan --license` | 仅执行许可证合规检查 |
+
+### Interaction Script | 交互脚本
+
+1. 执行指定类型的扫描
+2. 收集结果，依严重程度分类
+3. 展示分类报告
+
+**Decision: 扫描结果**
+- IF 发现 Critical/High → 列出 SLA 修复时限，建议立即处理
+- IF 仅 Medium/Low → 列入报告，建议排期处理
+- IF 发现机密泄漏 → 立即警告，建议轮换密钥
+
+**STOP**: 报告展示后等待用户决定修复优先顺序
+
+### Stop Points | 停止点
+
+| 停止点 | 等待内容 |
+|--------|---------|
+| 扫描报告展示后 | 用户决定修复项目 |
+| 修复建议展示后 | 确认应用修复 |
+
+### Error Handling | 错误处理
+
+| 错误条件 | AI 动作 |
+|----------|---------|
+| 扫描工具未安装 | 建议安装（npm audit 通常内置） |
+| 无 package.json 或 lock 文件 | 告知无法执行依赖扫描 |
+
+## Reference | 参考
+
+- Full standard: [security-scan-assistant](../security-scan-assistant/SKILL.md)

package/bundled/locales/zh-CN/skills/commands/sdd-retro.md

@@ -0,0 +1,40 @@
+---
+description: [UDS] Create retroactive specs for untracked feat/fix commits
+allowed-tools: Read, Write, Grep, Glob, Bash(git log:*), Bash(git show:*), Bash(git diff:*), Bash(mkdir:*)
+argument-hint: "[--since=<date> | --last=<N> | 自动扫描]"
+---
+
+# Retroactive Spec Generator | 追溯 Spec 生成器
+
+Create lightweight specification documents for past changes that were committed without spec tracking.
+
+为过去未追踪 spec 的已提交变更，创建轻量规格文件。
+
+## Workflow | 工作流程
+
+1. **扫描** — 在 `git log` 中搜索消息中没有 `Refs:` 的 `feat`/`fix` commits
+2. **分组** — 按 scope 将相关 commits 聚类
+3. **生成** — 使用标准 SDD 格式创建追溯 spec，状态为 `Status: Draft`
+4. **确认** — 展示给用户审查后再写入 `docs/specs/`
+
+## Options | 选项
+
+| Option | Description | 说明 |
+|--------|-------------|------|
+| `--since=2026-01-01` | Only scan commits after date | 仅扫描指定日期后的 commits |
+| `--last=20` | Only scan last N commits | 仅扫描最近 N 笔 commits |
+| (no args) | Scan all feat/fix commits | 扫描所有 feat/fix commits |
+
+## Usage | 使用方式
+
+```
+/sdd-retro              # 扫描所有未追踪的 commits
+/sdd-retro --since=2026-01-01
+/sdd-retro --last=10
+```
+
+## Reference | 参考
+
+- SDD workflow: [sdd command](sdd.md)
+- Commit standards: [commit command](commit.md)
+- Spec: [SPEC-011](../../docs/specs/cli/shared/SPEC-011-retroactive-spec-tracking.md)