universal-dev-standards 3.5.1-beta.1 → 3.5.1-beta.11

package/bundled/locales/zh-CN/skills/claude-code/refactoring-assistant/SKILL.md

@@ -0,0 +1,162 @@
+---
+source: skills/claude-code/refactoring-assistant/SKILL.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2026-01-12
+status: current
+name: refactoring-assistant
+description: |
+  引導重構决策和大規模程序码改进。
+  使用时机：重構程序码、遺留系统現代化、技術債、重写决策。
+  关鍵字：refactor, rewrite, legacy, strangler, technical debt, 重構, 重写, 技術債.
+---
+
+# 重構助手
+
+> **语言**: [English](../../../../../skills/claude-code/refactoring-assistant/SKILL.md) | 简体中文
+
+**版本**: 1.0.0
+**最後更新**: 2026-01-12
+**適用範圍**: Claude Code Skills
+
+---
+
+## 目的
+
+本技能提供重構与重写的决策框架、大規模重構模式，以及技術債管理。
+
+---
+
+## 快速參考（YAML 壓縮格式）
+
+```yaml
+# === 决策：重構 vs 重写 ===
+decision_tree:
+  - q: "程序码在生产環境运行？"
+    n: "→ 考慮重写（風險較低）"
+    y: next
+  - q: "了解程序码的功能？"
+    n: "→ 先写特徵测试"
+    y: next
+  - q: "测试覆蓋率 >60%？"
+    n: "→ 先補测试"
+    y: next
+  - q: "核心架構可修復？"
+    n: "→ Strangler Fig 模式"
+    y: "→ 增量重構 ✓"
+
+comparison_matrix:
+  favor_refactor: [大型程序庫, 良好测试, 业务关鍵, 团队熟悉, 架構健全, 时间緊迫, 低風險]
+  favor_rewrite: [小型獨立, 無测试, 可容忍停机, 無人熟悉, 架構有缺陷, 时间充裕, 較高風險]
+
+# === 警告：第二系统效应 ===
+rewrite_antipatterns:
+  - "加入原本没有的功能"
+  - "为未來彈性過度抽象"
+  - "忽略現有系统的經驗教訓"
+quote: "第二个系统是一个人设计過最危險的系统。— Fred Brooks"
+
+# === 規模：重構策略 ===
+scales:
+  small:
+    duration: "5-15 分鐘"
+    scope: "单一方法/类别"
+    techniques: [提取方法, 重新命名, 內联变數, 替换魔術數字]
+  medium:
+    duration: "數小时到數天"
+    scope: "一个功能/模組"
+    checklist: [定義範圍, 識别入口点, "覆蓋率>80%", 增量提交, 与团队溝通]
+  large:
+    duration: "數周到數月"
+    scope: "多个模組/系统"
+    patterns: [strangler_fig, branch_by_abstraction, parallel_change]
+
+# === 模式：大規模重構 ===
+strangler_fig:
+  phases:
+    1_攔截: "请求 → 外觀 → 舊系统(100%)"
+    2_迁移: "请求 → 外觀 → [新系统(功能A), 舊系统(其餘)]"
+    3_完成: "请求 → 新系统(100%) [舊系统除役]"
+
+branch_by_abstraction:
+  steps:
+    1: "客户端 → 抽象层(界面) → 舊实作"
+    2: "客户端 → 抽象层 → [舊实作, 新实作(切换)]"
+    3: "客户端 → 新实作 [移除舊实作]"
+
+expand_migrate_contract:
+  phases:
+    expand: "新增新的，保留舊的，新程序用新的，舊程序仍可用"
+    migrate: "更新所有客户端使用新的，验证，数据迁移"
+    contract: "移除舊的，清理，更新文件"
+
+# === 遺留程序码：策略 ===
+legacy:
+  definition: "没有测试的程序码（不論年齡）"
+  dilemma: "安全修改需要测试 → 加测试需要修改程序码"
+  solution: "使用安全技術先加测试"
+
+characterization_tests:
+  purpose: "捕捉現有行为（非验证正确性）"
+  process:
+    1: "呼叫要理解的程序码"
+    2: "写预期会失败的斷言"
+    3: "执行，觀察实际結果"
+    4: "更新斷言以匹配实际行为"
+    5: "重複直到涵蓋需要修改的行为"
+
+# === 技術債管理 ===
+quadrant: # Martin Fowler
+  prudent_deliberate: "我們知道这是債务"
+  reckless_deliberate: "没时间做设计"
+  prudent_inadvertent: "現在知道应該怎麼做了"
+  reckless_inadvertent: "什麼是分层？"
+
+priority:
+  high: {criteria: "阻塞开发，頻繁出錯", action: "立即处理"}
+  medium: {criteria: "拖慢开发，增加複雜度", action: "規划到下个迭代"}
+  low: {criteria: "小麻煩，影響局部", action: "有机会就处理"}
+```
+
+---
+
+## 配置偵测
+
+### 偵测順序
+
+1. 检查 `CONTRIBUTING.md` 中的「停用技能」區段
+2. 检查 `CONTRIBUTING.md` 中的「重構标准」區段
+3. 如果未找到，**预设使用标准重構实踐**
+
+---
+
+## 详细指南
+
+完整标准請參阅：
+- [重構标准](../../../core/refactoring-standards.md)
+
+---
+
+## 相关标准
+
+- [重構标准](../../../core/refactoring-standards.md) - 核心标准
+- [测试驅动开发](../../../core/test-driven-development.md) - TDD 重構阶段
+- [程序码审查检查清单](../../../core/code-review-checklist.md) - 重構 PR 审查
+- [簽入标准](../../../core/checkin-standards.md) - 提交前要求
+- [TDD 助手](../tdd-assistant/SKILL.md) - TDD 工作流程
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|------|------|------|
+| 1.0.0 | 2026-01-12 | 初始發布 |
+
+---
+
+## 授权
+
+本技能以 [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/claude-code/release-standards/SKILL.md

@@ -0,0 +1,191 @@
+---
+source: skills/claude-code/release-standards/SKILL.md
+source_version: 1.1.0
+translation_version: 1.1.0
+last_synced: 2026-01-02
+status: current
+name: release-standards
+description: |
+  語意化版本控制和变更日誌格式化的软体發布标准。
+  使用时机：准备發布、更新版本号、撰写变更日誌。
+  关鍵字：version, release, changelog, semver, major, minor, patch, 版本, 發布, 变更日誌。
+---
+
+# 發布标准
+
+> **语言**: [English](../../../../../skills/claude-code/release-standards/SKILL.md) | 简体中文
+
+**版本**: 1.1.0
+**最後更新**: 2026-01-02
+**適用範圍**: Claude Code Skills
+
+---
+
+## 目的
+
+本技能提供語意化版本控制和变更日誌格式化标准。
+
+## 快速參考
+
+### 語意化版本格式
+
+```
+MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]
+
+Examples:
+2.3.1
+1.0.0-alpha.1
+3.2.0-beta.2+20250112
+```
+
+### 版本递增規則
+
+| 組成部分 | 何时递增 | 範例 |
+|-----------|-------------------|----------|
+| **MAJOR** | 重大变更 | 1.9.5 → 2.0.0 |
+| **MINOR** | 新功能（向後相容） | 2.3.5 → 2.4.0 |
+| **PATCH** | 错误修復（向後相容） | 3.1.2 → 3.1.3 |
+
+### 预發布識别符
+
+| 識别符 | 穩定性 | 目標受眾 |
+|------------|-----------|----------|
+| `alpha` | 不穩定 | 內部团队 |
+| `beta` | 大致穩定 | 早期採用者 |
+| `rc` | 穩定 | Beta 测试者 |
+
+### CHANGELOG 分类
+
+| 分类 | 用途 |
+|----------|-------|
+| **Added** | 新功能 |
+| **Changed** | 現有功能的变更 |
+| **Deprecated** | 即將移除的功能 |
+| **Removed** | 已移除的功能 |
+| **Fixed** | 错误修復 |
+| **Security** | 安全性漏洞修復 |
+
+## 详细指南
+
+完整标准請參阅：
+- [語意化版本控制指南](./semantic-versioning.md)
+- [变更日誌格式](./changelog-format.md)
+- [發布流程指南](./release-workflow.md) - 本项目完整發布流程
+
+## CHANGELOG 条目格式
+
+```markdown
+## [VERSION] - YYYY-MM-DD
+
+### Added
+- Add user dashboard with customizable widgets (#123)
+
+### Changed
+- **BREAKING**: Change API response format from XML to JSON
+
+### Fixed
+- Fix memory leak when processing large files (#456)
+
+### Security
+- Fix SQL injection vulnerability (CVE-2025-12345)
+```
+
+## 重大变更
+
+使用 **BREAKING** 前綴標记重大变更：
+
+```markdown
+### Changed
+- **BREAKING**: Remove deprecated `getUserById()`, use `getUser()` instead
+```
+
+## Git 标签
+
+```bash
+# Create annotated tag (recommended)
+git tag -a v1.2.0 -m "Release version 1.2.0"
+
+# Push tag to remote
+git push origin v1.2.0
+```
+
+## 版本排序
+
+```
+1.0.0-alpha.1 < 1.0.0-alpha.2 < 1.0.0-beta.1 < 1.0.0-rc.1 < 1.0.0
+```
+
+---
+
+## 配置檢测
+
+本技能支援项目特定配置。
+
+### 檢测順序
+
+1. 检查 `CONTRIBUTING.md` 中的「Disabled Skills」段落
+   - 如果列出此技能，則該项目停用此技能
+2. 检查 `CONTRIBUTING.md` 中的「Release Standards」段落
+3. 如果未找到，**预设使用語意化版本控制和 Keep a Changelog 格式**
+
+### 首次设置
+
+如果未找到配置且上下文不明确：
+
+1. 詢問使用者：「此项目尚未配置發布标准。您想使用語意化版本控制嗎？」
+2. 使用者选择後，建议在 `CONTRIBUTING.md` 中记录：
+
+```markdown
+## Release Standards
+
+### Versioning
+This project uses **Semantic Versioning** (MAJOR.MINOR.PATCH).
+
+### Changelog
+This project follows **Keep a Changelog** format.
+```
+
+### 配置範例
+
+在项目的 `CONTRIBUTING.md` 中：
+
+```markdown
+## Release Standards
+
+### Versioning
+This project uses **Semantic Versioning** (MAJOR.MINOR.PATCH).
+
+### Changelog
+This project follows **Keep a Changelog** format.
+
+### Release Process
+1. Update version in package.json
+2. Update CHANGELOG.md
+3. Create git tag with `v` prefix (e.g., v1.2.0)
+4. Push tag to trigger release workflow
+```
+
+---
+
+## 相关标准
+
+- [版本控制](../../core/versioning.md)
+- [变更日誌标准](../../core/changelog-standards.md)
+- [Git 工作流程](../../core/git-workflow.md)
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更内容 |
+|---------|------|---------|
+| 1.1.0 | 2026-01-02 | 新增：發布流程指南，包含完整發布流程 |
+| 1.0.0 | 2025-12-24 | 新增：标准段落（目的、相关标准、版本历史、授权条款） |
+
+---
+
+## 授权条款
+
+本技能依据 [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/claude-code/release-standards/changelog-format.md

@@ -0,0 +1,247 @@
+---
+source: skills/claude-code/release-standards/changelog-format.md
+source_version: 1.0.0
+translation_version: 1.0.0
+last_synced: 2025-12-25
+status: current
+---
+
+# 变更日誌格式指南
+
+> **语言**: [English](../../../../../skills/claude-code/release-standards/changelog-format.md) | 简体中文
+
+**版本**: 1.0.0
+**最後更新**: 2025-12-24
+**適用範圍**: Claude Code Skills
+
+---
+
+## 目的
+
+本文件提供撰写和格式化变更日誌文件的指南。
+
+此标准遵循 [Keep a Changelog](https://keepachangelog.com/) 格式。
+
+## 文件结构
+
+```markdown
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/),
+and this project adheres to [Semantic Versioning](https://semver.org/).
+
+## [Unreleased]
+
+### Added
+- New features not yet released
+
+## [1.2.0] - 2025-12-15
+
+### Added
+- Feature description
+
+### Changed
+- Change description
+
+### Fixed
+- Bug fix description
+
+[Unreleased]: https://github.com/user/repo/compare/v1.2.0...HEAD
+[1.2.0]: https://github.com/user/repo/compare/v1.1.0...v1.2.0
+```
+
+---
+
+## 分类
+
+| 分类 | 用途 | 何时使用 |
+|----------|-------|-------------|
+| **Added** | 新功能 | 为使用者提供的新功能 |
+| **Changed** | 修改 | 現有功能的变更 |
+| **Deprecated** | 即將移除 | 即將被移除的功能 |
+| **Removed** | 已移除功能 | 在此版本中移除的功能 |
+| **Fixed** | 错误修復 | 任何错误修復 |
+| **Security** | 安全性修補 | 漏洞修復 |
+
+---
+
+## 版本標題格式
+
+```markdown
+## [VERSION] - YYYY-MM-DD
+```
+
+**範例**:
+```markdown
+## [2.0.0] - 2025-12-15
+## [1.5.0-beta.1] - 2025-12-01
+## [Unreleased]
+```
+
+---
+
+## 条目格式
+
+```markdown
+- [Action verb] [what changed] ([reference])
+```
+
+**範例**:
+```markdown
+### Added
+- Add user dashboard with customizable widgets (#123)
+- Add support for PostgreSQL 15 (PR #456)
+
+### Changed
+- **BREAKING**: Change API response format from XML to JSON (#789)
+- Update minimum Node.js version to 18.0 (#101)
+
+### Fixed
+- Fix memory leak when processing large files (#112)
+- Fix incorrect date formatting in reports (#134)
+```
+
+---
+
+## 破壞性变更
+
+使用 **BREAKING** 前綴清楚標记破壞性变更:
+
+```markdown
+### Changed
+- **BREAKING**: Remove deprecated `getUserById()` method, use `getUser()` instead
+- **BREAKING**: Change configuration file format from YAML to TOML
+
+### Removed
+- **BREAKING**: Remove support for Node.js 14
+```
+
+---
+
+## 安全性公告
+
+如果可用，請包含嚴重程度和 CVE:
+
+```markdown
+### Security
+- Fix SQL injection vulnerability in search endpoint (HIGH, CVE-2025-12345)
+- Fix XSS vulnerability in comment rendering (MEDIUM)
+- Update dependency `lodash` to patch prototype pollution (LOW)
+```
+
+---
+
+## 提交消息与变更日誌对应
+
+| 提交类型 | 变更日誌分类 | 备註 |
+|-------------|-------------------|-------|
+| `feat` | **Added** | 新功能 |
+| `fix` | **Fixed** | 错误修復 |
+| `perf` | **Changed** | 效能改善 |
+| `refactor` | *(通常省略)* | 內部变更 |
+| `docs` | *(通常省略)* | 僅文件 |
+| `test` | *(通常省略)* | 僅测试 |
+| `chore` | *(通常省略)* | 維護 |
+| `BREAKING CHANGE` | **Changed** 或 **Removed** | 使用 **BREAKING** 前綴 |
+| `security` | **Security** | 安全性修補 |
+| `deprecate` | **Deprecated** | 棄用通知 |
+
+---
+
+## 排除規則
+
+以下项目**不应**记录在变更日誌中:
+
+| 分类 | 範例 | 原因 |
+|----------|----------|--------|
+| 建置输出 | `dist/`, `build/`, `bin/` | 产生的文件 |
+| 相依套件 | `node_modules/`, lock files | 自动管理 |
+| 本地设置 | `.env`, `*.local.json` | 環境特定 |
+| IDE 设置 | `.vscode/`, `.idea/` | 开发者偏好 |
+| 內部重構 | 程序码風格、变數名称 | 無使用者影響 |
+
+---
+
+## 撰写技巧
+
+### 为使用者撰写，而非开发者
+
+| 良好範例 | 不良範例 |
+|------|-----|
+| Add dark mode theme option | Implement ThemeProvider with context |
+| Fix login timeout on slow networks | Fix race condition in AuthService |
+| Improve page load speed by 40% | Optimize SQL queries with indexes |
+
+---
+
+## 多语言支援
+
+### 雙語条目
+
+```markdown
+## [1.2.0] - 2025-12-15
+
+### Added | 新增
+- Add dark mode support
+  新增深色模式支援
+- Add CSV export feature
+  新增 CSV 匯出功能
+
+### Fixed | 修復
+- Fix login timeout issue
+  修復登入逾时問題
+```
+
+---
+
+## 自动化
+
+### conventional-changelog
+
+```bash
+# Install
+npm install -g conventional-changelog-cli
+
+# Generate (append to existing)
+conventional-changelog -p angular -i CHANGELOG.md -s
+```
+
+### semantic-release
+
+```json
+// .releaserc.json
+{
+  "branches": ["main"],
+  "plugins": [
+    "@semantic-release/commit-analyzer",
+    "@semantic-release/release-notes-generator",
+    "@semantic-release/changelog",
+    "@semantic-release/git"
+  ]
+}
+```
+
+---
+
+## 相关标准
+
+- [Changelog Standards](../../../../../core/changelog-standards.md)
+- [Semantic Versioning Guide](./semantic-versioning.md)
+
+---
+
+## 版本历史
+
+| 版本 | 日期 | 变更 |
+|---------|------|---------|
+| 1.0.0 | 2025-12-24 | 新增: 标准章节 (目的、相关标准、版本历史、授权条款) |
+
+---
+
+## 授权条款
+
+本文件依据 [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) 授权發布。
+
+**來源**: [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards)