universal-dev-standards 4.1.0 → 5.0.0-beta.10

package/bundled/locales/zh-CN/STANDARDS-MAPPING.md

@@ -139,7 +139,7 @@ status: current
 
 | 工具 | 档案 | 格式 | 状态 |
 |-----|-----|-----|-----|
-| Claude Code | skills/claude-code/**/*.md | SKILL.md | ✅ 完成 |
+| Claude Code | skills/**/*.md | SKILL.md | ✅ 完成 |
 | Cursor | skills/cursor/.cursorrules | Rules 档案 | ✅ 完成 |
 | Windsurf | skills/windsurf/.windsurfrules | Rules 档案 | ✅ 完成 |
 | Cline | skills/cline/.clinerules | Rules 档案 | ✅ 完成 |

package/bundled/locales/zh-CN/adoption/ADOPTION-GUIDE.md

@@ -8,7 +8,7 @@ status: current
 
 # 规范采用指南
 
-> **语言**: [English](../../adoption/ADOPTION-GUIDE.md) | 繁体中文
+> **语言**: [English](../../../adoption/ADOPTION-GUIDE.md) | 繁体中文
 >
 > 版本 1.0.0
 
@@ -95,7 +95,7 @@ status: current
 
 # 或手动复制（macOS / Linux）
 mkdir -p ~/.claude/skills
-cp -r skills/claude-code/commit-standards ~/.claude/skills/
+cp -r skills/commit-standards ~/.claude/skills/
 ```
 
 ### 类别二：参考文件
@@ -247,7 +247,7 @@ Copy-Item <source-file> .standards\
 ```bash
 git clone https://github.com/AsiaOstrich/universal-dev-standards.git
 mkdir -p ~/.claude/skills
-cp -r universal-dev-standards/skills/claude-code/commit-standards ~/.claude/skills/
+cp -r universal-dev-standards/skills/commit-standards ~/.claude/skills/
 ```
 
 **替代方案：手动复制（Windows PowerShell）**

package/bundled/locales/zh-CN/adoption/DAILY-WORKFLOW-GUIDE.md

@@ -1,15 +1,15 @@
 ---
 source: ../../../adoption/DAILY-WORKFLOW-GUIDE.md
-source_version: 1.0.0
-translation_version: 1.0.0
-last_synced: 2026-01-19
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-02-10
 status: current
 ---
 
 # 日常开发工作流程指南
 
-**版本**: 1.0.0
-**最后更新**: 2026-01-19
+**版本**: 1.1.0
+**最后更新**: 2026-02-10
 
 > **语言**: [English](../../../adoption/DAILY-WORKFLOW-GUIDE.md) | [繁體中文](../../zh-TW/adoption/DAILY-WORKFLOW-GUIDE.md) | 简体中文
 
@@ -19,6 +19,7 @@ status: current
 
 ## 目录
 
+- [Phase 0：专案现况评估](#phase-0专案现况评估)
 - [核心原则：渐进式采用](#核心原则渐进式采用)
 - [根据任务类型选择工作流程](#根据任务类型选择工作流程)
 - [Greenfield 与 Brownfield 专案](#greenfield-与-brownfield-专案)
@@ -34,6 +35,41 @@ status: current
 
 ---
 
+## Phase 0：专案现况评估
+
+> **使用时机**：首次接触既有代码库，或在不熟悉的模块进行重大变更之前。
+
+在 Brownfield 专案进行代码变更之前，先执行 `/discover` 评估现况：
+
+```
+1. /discover [area]     → 评估专案健康度、架构、风险
+2. /reverse spec        → 反向工程现有代码为规格（如有需要）
+3. /sdd                 → 撰写新功能规格
+4. 实作                  → 使用 /tdd 或 /bdd 在测试保护下实作
+```
+
+### 评估维度
+
+| 维度 | 检查项目 |
+|------|----------|
+| **架构** | 模块结构、依赖图、入口点 |
+| **依赖性** | 过时套件、已知漏洞、授权风险 |
+| **测试覆盖** | 现有测试、覆盖率缺口、测试质量 |
+| **安全性** | `npm audit` 结果、硬编码密钥、暴露端点 |
+| **技术债** | TODO 标记、代码重复、复杂度热点 |
+
+### 输出
+
+Discovery Report 提供：
+- 整体健康度分数（1-10）
+- 各维度分数与关键发现
+- **结论**：GO / NO-GO / CONDITIONAL
+- 优先级排序的建议（HIGH / MED / LOW）
+
+> **下一步**：评估完成后，如需理解现有代码请使用 `/reverse`，然后用 `/sdd` 设计新功能。
+
+---
+
 ## 核心原则：渐进式采用
 
 ### 常见误解 vs 实际做法
@@ -71,6 +107,12 @@ status: current
 │                    任务类型 → 工作流程选择                        │
 ├─────────────────────────────────────────────────────────────────┤
 │                                                                 │
+│  第一次接触这个代码库？                                          │
+│  │                                                              │
+│  ├─ 是 → 先执行 /discover（Phase 0 评估）                       │
+│  │                                                              │
+│  └─ 否（熟悉代码库）                                            │
+│                                                                 │
 │  这是全新功能吗？                                                │
 │  │                                                              │
 │  ├─ 是（Greenfield）                                            │
@@ -209,6 +251,11 @@ test('should reject email without domain', () => {
 │                                                                │
 │  ⚠️  只有这种情况才需要较完整的流程                             │
 │                                                                │
+│  0️⃣  评估现况（Discovery + 反向工程）                          │
+│      ├─ /discover 评估专案健康度与风险                          │
+│      ├─ /reverse spec 反向工程现有代码                          │
+│      └─ 输出：Discovery Report + 现有规格                      │
+│                                                                │
 │  1️⃣  撰写变更规格（SDD）                                       │
 │      ├─ 描述为什么要重构                                       │
 │      ├─ 定义影响范围                                           │
@@ -248,7 +295,7 @@ test('should reject email without domain', () => {
     ├─ 根据 AC 撰写技术设计文档
     ├─ 技术审查并获得批准
     └─ 输出：SPEC-XXX 文档
-    💡 命令：/spec
+    💡 命令：/sdd
 
 3️⃣  BDD 阶段：撰写行为规格
     ├─ Discovery：从 AC 识别场景
@@ -314,14 +361,22 @@ test('should reject email without domain', () => {
 
 | 命令 | 用途 | 使用时机 |
 |------|------|----------|
+| `/discover` | 评估专案健康度与风险 | 首次接触代码库、重大变更前 |
+| `/reverse` | 反向工程代码为规格/BDD/TDD | 理解现有代码 |
 | `/tdd` | 启动 TDD 工作流程 | 写代码时 |
 | `/bdd` | 启动 BDD 工作流程 | 设计行为规格时 |
-| `/spec` | 启动 SDD 工作流程 | 需要技术规格时 |
+| `/sdd` | 启动 SDD 工作流程 | 需要技术规格时 |
 | `/atdd` | 启动 ATDD 工作流程 | 需要正式验收的功能 |
+| `/refactor` | 启动重构工作流程 | 改善代码结构 |
 | `/methodology` | 查看/切换当前方法论 | 管理开发流程 |
 | `/commit` | 生成规范的 commit message | 提交代码 |
 | `/review` | 启动代码审查 | 审查 PR |
 | `/requirement` | 撰写需求文档 | 定义 User Story |
+| `/checkin` | 提交前质量验证 | 提交代码前 |
+| `/changelog` | 生成变更日志条目 | 准备发布期间 |
+| `/coverage` | 分析测试覆盖率 | 评估测试质量 |
+| `/docs` | 管理文档 | 撰写/更新文档 |
+| `/release` | 引导发布流程 | 准备发布 |
 
 ---
 
@@ -444,6 +499,9 @@ test('should reject email without domain', () => {
 ## 相关标准
 
 - [采用指南](ADOPTION-GUIDE.md) - 如何安装 UDS
+- [专案现况评估](../../../skills/project-discovery/SKILL.md) - Phase 0 专案评估
+- [反向工程标准](../../../core/reverse-engineering-standards.md) - 反向工程工作流程
+- [重构标准](../../../core/refactoring-standards.md) - 重构工作流程
 - [测试驱动开发](../../../core/test-driven-development.md) - TDD 标准（包含 Golden Master Testing）
 - [行为驱动开发](../../../core/behavior-driven-development.md) - BDD 工作流程
 - [验收测试驱动开发](../../../core/acceptance-test-driven-development.md) - ATDD 工作流程
@@ -457,6 +515,7 @@ test('should reject email without domain', () => {
 
 | 版本 | 日期 | 变更 |
 |------|------|------|
+| 1.1.0 | 2026-02-10 | 新增 Phase 0 专案评估、/discover + /reverse + /refactor 命令 |
 | 1.0.0 | 2026-01-19 | 初版日常工作流程指南 |
 
 ---

package/bundled/locales/zh-CN/adoption/STATIC-DYNAMIC-GUIDE.md

@@ -86,7 +86,7 @@ status: current
 
 | 规范 | 核心规则 | 核心目的 |
 |------|---------|---------|
-| [checkin-standards](../../core/checkin-standards.md) | 编译通过、测试通过、覆盖率维持 | 确保 commit 前的程式码品质 |
+| [checkin-standards](../../../core/checkin-standards.md) | 编译通过、测试通过、覆盖率维持 | 确保 commit 前的程式码品质 |
 
 ### 部署方式
 
@@ -119,8 +119,8 @@ status: current
 
 | 规范 | 静态元件 | 动态技能 | 触发关键字 |
 |------|----------|----------|------------|
-| [anti-hallucination](../../core/anti-hallucination.md) | 确定性标签、建议原则 | ai-collaboration-standards | certainty, assumption, 确定性 |
-| [project-structure](../../core/project-structure.md) | 目录惯例 | project-structure-guide | structure, organization, 结构 |
+| [anti-hallucination](../../../core/anti-hallucination.md) | 确定性标签、建议原则 | ai-collaboration-standards | certainty, assumption, 确定性 |
+| [project-structure](../../../core/project-structure.md) | 目录惯例 | project-structure-guide | structure, organization, 结构 |
 
 ### 部署方式
 
@@ -147,22 +147,22 @@ status: current
 
 | 规范 | 技能 | 触发关键字 |
 |------|------|-----------|
-| [anti-hallucination](../../core/anti-hallucination.md) | ai-collaboration-standards | certainty, assumption, 确定性 |
-| [changelog-standards](../../core/changelog-standards.md) | changelog-guide | changelog, release notes, 变更日志 |
-| [code-review-checklist](../../core/code-review-checklist.md) | code-review-assistant | review, PR, 审查 |
-| [commit-message-guide](../../core/commit-message-guide.md) | commit-standards | commit, git, 提交, feat, fix |
-| [documentation-structure](../../core/documentation-structure.md) | documentation-guide | README, docs, 文件 |
-| [documentation-writing-standards](../../core/documentation-writing-standards.md) | documentation-guide | documentation |
-| [error-code-standards](../../core/error-code-standards.md) | error-code-guide | error code, error handling, 错误码 |
-| [git-workflow](../../core/git-workflow.md) | git-workflow-guide | branch, merge, 分支 |
-| [logging-standards](../../core/logging-standards.md) | logging-guide | logging, log level, 日志 |
-| [project-structure](../../core/project-structure.md) | project-structure-guide | structure, organization, 结构 |
-| [spec-driven-development](../../core/spec-driven-development.md) | requirement-assistant | spec, SDD, 规格, 新功能 |
-| [spec-driven-development](../../core/spec-driven-development.md) | spec-driven-dev | spec, proposal, 提案 |
-| [test-driven-development](../../core/test-driven-development.md) | tdd-assistant | TDD, test first, 红绿重构 |
-| [test-completeness-dimensions](../../core/test-completeness-dimensions.md) | test-coverage-assistant | test coverage, 7 dimensions, 测试覆盖 |
-| [testing-standards](../../core/testing-standards.md) | testing-guide | test, 测试, coverage |
-| [versioning](../../core/versioning.md) | release-standards | version, release, 版本 |
+| [anti-hallucination](../../../core/anti-hallucination.md) | ai-collaboration-standards | certainty, assumption, 确定性 |
+| [changelog-standards](../../../core/changelog-standards.md) | changelog-guide | changelog, release notes, 变更日志 |
+| [code-review-checklist](../../../core/code-review-checklist.md) | code-review-assistant | review, PR, 审查 |
+| [commit-message-guide](../../../core/commit-message-guide.md) | commit-standards | commit, git, 提交, feat, fix |
+| [documentation-structure](../../../core/documentation-structure.md) | documentation-guide | README, docs, 文件 |
+| [documentation-writing-standards](../../../core/documentation-writing-standards.md) | documentation-guide | documentation |
+| [error-code-standards](../../../core/error-code-standards.md) | error-code-guide | error code, error handling, 错误码 |
+| [git-workflow](../../../core/git-workflow.md) | git-workflow-guide | branch, merge, 分支 |
+| [logging-standards](../../../core/logging-standards.md) | logging-guide | logging, log level, 日志 |
+| [project-structure](../../../core/project-structure.md) | project-structure-guide | structure, organization, 结构 |
+| [spec-driven-development](../../../core/spec-driven-development.md) | requirement-assistant | spec, SDD, 规格, 新功能 |
+| [spec-driven-development](../../../core/spec-driven-development.md) | spec-driven-dev | spec, proposal, 提案 |
+| [test-driven-development](../../../core/test-driven-development.md) | tdd-assistant | TDD, test first, 红绿重构 |
+| [test-completeness-dimensions](../../../core/test-completeness-dimensions.md) | test-coverage-assistant | test coverage, 7 dimensions, 测试覆盖 |
+| [testing-standards](../../../core/testing-standards.md) | testing-guide | test, 测试, coverage |
+| [versioning](../../../core/versioning.md) | release-standards | version, release, 版本 |
 
 ### 部署方式
 
@@ -177,7 +177,7 @@ status: current
 **替代方案：手动安装（macOS / Linux）**
 ```bash
 mkdir -p ~/.claude/skills
-cp -r skills/claude-code/commit-standards ~/.claude/skills/
+cp -r skills/commit-standards ~/.claude/skills/
 ```
 
 **替代方案：手动安装（Windows PowerShell）**
@@ -186,7 +186,7 @@ cp -r skills/claude-code/commit-standards ~/.claude/skills/
 Copy-Item -Recurse skills\claude-code\commit-standards $env:USERPROFILE\.claude\skills\
 ```
 
-详见 [Claude Code Skills README](../../../skills/claude-code/README.md)。
+详见 [Claude Code Skills README](../../../skills/README.md)。
 
 ---
 
@@ -281,7 +281,7 @@ description: |
 ## 相关资源
 
 - [CLAUDE.md 范本](../../../templates/CLAUDE.md.template) - 可立即使用的静态规则范本
-- [Claude Code Skills](../../../skills/claude-code/README.md) - 技能安装指南
+- [Claude Code Skills](../../../skills/README.md) - 技能安装指南
 - [采用指南](ADOPTION-GUIDE.md) - 整体采用策略
 - [MAINTENANCE.md](../MAINTENANCE.md) - 如何新增/更新技能（维护者专用）
 

package/bundled/locales/zh-CN/adoption/checklists/enterprise.md

@@ -8,7 +8,7 @@ status: current
 
 # 等级三：企业采用检查清单
 
-> **语言**: [English](../../../adoption/checklists/enterprise.md) | 繁体中文
+> **语言**: [English](../../../../adoption/checklists/enterprise.md) | 繁体中文
 
 > 企业或受监管专案的全面标准
 >
@@ -311,10 +311,10 @@ project/
 
 - [Essential Adoption Checklist](minimal.md) - Level 1 基本采用
 - [Recommended Adoption Checklist](recommended.md) - Level 2 推荐采用
-- [Documentation Writing Standards](../../../core/documentation-writing-standards.md) - 文件撰写规范
-- [Project Structure](../../../core/project-structure.md) - 专案结构标准
-- [Checkin Standards](../../../core/checkin-standards.md) - 签入标准
-- [Spec-Driven Development](../../../core/spec-driven-development.md) - 规格驱动开发
+- [Documentation Writing Standards](../../../../core/documentation-writing-standards.md) - 文件撰写规范
+- [Project Structure](../../../../core/project-structure.md) - 专案结构标准
+- [Checkin Standards](../../../../core/checkin-standards.md) - 签入标准
+- [Spec-Driven Development](../../../../core/spec-driven-development.md) - 规格驱动开发
 
 ---
 

package/bundled/locales/zh-CN/adoption/checklists/minimal.md

@@ -1,5 +1,5 @@
 ---
-source: adoption/checklists/minimal.md
+source: ../../../../adoption/checklists/minimal.md
 source_version: 1.0.1
 translation_version: 1.0.1
 last_synced: 2025-12-25
@@ -8,7 +8,7 @@ status: current
 
 # 等级 1：基本采用检查清单
 
-> **语言**: [English](../../../adoption/checklists/minimal.md) | 繁体中文
+> **语言**: [English](../../../../adoption/checklists/minimal.md) | 繁体中文
 
 > 任何专案的最低可行标准
 >
@@ -122,8 +122,8 @@ Copy-Item path\to\universal-dev-standards\core\spec-driven-development.md .stand
 
 - [Recommended Adoption Checklist](recommended.md) - Level 2 升级指南
 - [Enterprise Adoption Checklist](enterprise.md) - Level 3 升级指南
-- [Checkin Standards](../../../core/checkin-standards.md) - 签入标准
-- [Spec-Driven Development](../../../core/spec-driven-development.md) - 规格驱动开发
+- [Checkin Standards](../../../../core/checkin-standards.md) - 签入标准
+- [Spec-Driven Development](../../../../core/spec-driven-development.md) - 规格驱动开发
 
 ---
 

package/bundled/locales/zh-CN/adoption/checklists/recommended.md

@@ -8,7 +8,7 @@ status: current
 
 # 等级二：推荐采用检查清单
 
-> **语言**: [English](../../../adoption/checklists/recommended.md) | 繁体中文
+> **语言**: [English](../../../../adoption/checklists/recommended.md) | 繁体中文
 
 > 团队专案的专业品质标准
 >
@@ -251,10 +251,10 @@ Document decision in project README or CONTRIBUTING.md.
 
 - [Essential Adoption Checklist](minimal.md) - Level 1 基本采用
 - [Enterprise Adoption Checklist](enterprise.md) - Level 3 升级指南
-- [Checkin Standards](../../../core/checkin-standards.md) - 签入标准
-- [Git Workflow](../../../core/git-workflow.md) - Git 工作流程
-- [Testing Standards](../../../core/testing-standards.md) - 测试标准
-- [Code Review Checklist](../../../core/code-review-checklist.md) - 程式码审查
+- [Checkin Standards](../../../../core/checkin-standards.md) - 签入标准
+- [Git Workflow](../../../../core/git-workflow.md) - Git 工作流程
+- [Testing Standards](../../../../core/testing-standards.md) - 测试标准
+- [Code Review Checklist](../../../../core/code-review-checklist.md) - 程式码审查
 
 ---
 

package/bundled/locales/zh-CN/ai/MAINTENANCE.md

@@ -333,7 +333,7 @@ core/anti-hallucination.md                          ← 来源
 ├── locales/zh-TW/core/anti-hallucination.md
 ├── ai/standards/anti-hallucination.ai.yaml
 ├── locales/zh-TW/ai/standards/anti-hallucination.ai.yaml
-└── skills/claude-code/ai-collaboration-standards/
+└── skills/ai-collaboration-standards/
     ├── SKILL.md
     ├── anti-hallucination.md
     └── locales/zh-TW/.../
@@ -358,7 +358,7 @@ core/changelog-standards.md                         ← 来源
 ├── locales/zh-TW/ai/options/changelog/
 │   ├── keep-a-changelog.ai.yaml
 │   └── auto-generated.ai.yaml
-└── skills/claude-code/release-standards/
+└── skills/release-standards/
     ├── SKILL.md
     ├── changelog-format.md
     └── locales/zh-TW/.../
@@ -377,7 +377,7 @@ core/checkin-standards.md                           ← 来源
 ├── locales/zh-TW/core/checkin-standards.md
 ├── ai/standards/checkin-standards.ai.yaml
 ├── locales/zh-TW/ai/standards/checkin-standards.ai.yaml
-└── skills/claude-code/commit-standards/
+└── skills/commit-standards/
     ├── SKILL.md
     └── locales/zh-TW/.../
 ```
@@ -403,7 +403,7 @@ core/code-review-checklist.md                       ← 来源
 │   ├── pr-review.ai.yaml
 │   ├── pair-programming.ai.yaml
 │   └── automated-review.ai.yaml
-└── skills/claude-code/code-review-assistant/
+└── skills/code-review-assistant/
     ├── SKILL.md
     └── locales/zh-TW/.../
 ```
@@ -437,7 +437,7 @@ core/commit-message-guide.md                        ← 来源
 │   ├── english.ai.yaml
 │   ├── traditional-chinese.ai.yaml
 │   └── bilingual.ai.yaml
-└── skills/claude-code/commit-standards/
+└── skills/commit-standards/
     ├── SKILL.md
     └── locales/zh-TW/.../
 ```
@@ -463,7 +463,7 @@ core/documentation-structure.md                     ← 来源
 │   ├── markdown-docs.ai.yaml
 │   ├── api-docs.ai.yaml
 │   └── wiki-style.ai.yaml
-└── skills/claude-code/documentation-guide/
+└── skills/documentation-guide/
     ├── SKILL.md
     └── locales/zh-TW/.../
 ```
@@ -481,7 +481,7 @@ core/documentation-writing-standards.md             ← 来源
 ├── locales/zh-TW/core/documentation-writing-standards.md
 ├── ai/standards/documentation-writing-standards.ai.yaml
 ├── locales/zh-TW/ai/standards/documentation-writing-standards.ai.yaml
-└── skills/claude-code/documentation-guide/
+└── skills/documentation-guide/
     ├── SKILL.md
     └── locales/zh-TW/.../
 ```
@@ -527,7 +527,7 @@ core/git-workflow.md                                ← 来源
 │   └── (6 个 .ai.yaml 档案)
 ├── locales/zh-TW/ai/options/git-workflow/
 │   └── (6 个翻译的 .ai.yaml 档案)
-└── skills/claude-code/git-workflow-guide/
+└── skills/git-workflow-guide/
     ├── SKILL.md
     └── locales/zh-TW/.../
 ```
@@ -581,7 +581,7 @@ core/project-structure.md                           ← 来源
 │   └── swift.ai.yaml     ← 仅 YAML（无 MD）
 ├── locales/zh-TW/ai/options/project-structure/
 │   └── (10 个翻译的 .ai.yaml 档案)
-└── skills/claude-code/project-structure-guide/（如存在）
+└── skills/project-structure-guide/（如存在）
 ```
 
 **需更新档案**: ~38 个
@@ -614,7 +614,7 @@ core/test-completeness-dimensions.md                ← 来源
 ├── locales/zh-TW/core/test-completeness-dimensions.md
 ├── ai/standards/test-completeness-dimensions.ai.yaml
 ├── locales/zh-TW/ai/standards/test-completeness-dimensions.ai.yaml
-└── skills/claude-code/testing-guide/
+└── skills/testing-guide/
     ├── SKILL.md
     └── locales/zh-TW/.../
 ```
@@ -651,7 +651,7 @@ core/testing-standards.md                           ← 来源
 │   └── contract-testing.ai.yaml   ← 仅 YAML
 ├── locales/zh-TW/ai/options/testing/
 │   └── (9 个翻译的 .ai.yaml 档案)
-└── skills/claude-code/testing-guide/
+└── skills/testing-guide/
     ├── SKILL.md
     ├── testing-pyramid.md
     └── locales/zh-TW/.../
@@ -672,7 +672,7 @@ core/versioning.md                                  ← 来源
 ├── locales/zh-TW/core/versioning.md
 ├── ai/standards/versioning.ai.yaml
 ├── locales/zh-TW/ai/standards/versioning.ai.yaml
-└── skills/claude-code/release-standards/
+└── skills/release-standards/
     ├── SKILL.md
     ├── semantic-versioning.md
     └── locales/zh-TW/.../
@@ -719,7 +719,7 @@ core/versioning.md                                  ← 来源
 6. locales/zh-TW/options/{category}/     ← 翻译 MD 选项
 7. ai/options/{category}/*.ai.yaml       ← 如有 YAML 选项
 8. locales/zh-TW/ai/options/{category}/  ← 翻译 YAML 选项
-9. skills/claude-code/{skill}/           ← 更新相关技能
+9. skills/{skill}/           ← 更新相关技能
 10. locales/zh-TW/skills/...             ← 翻译技能
 ```