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

package/bundled/skills/claude-code/README.md

@@ -1,215 +0,0 @@
-# Claude Code Skills
-
-Claude Code Skills for software development standards.
-
-> Derived from [universal-dev-standards](https://github.com/AsiaOstrich/universal-dev-standards) core standards.
-
-## Overview
-
-These skills are automatically triggered based on context when using Claude Code, helping you:
-
-- Prevent AI hallucination with evidence-based responses
-- Write consistent, well-formatted commit messages
-- Conduct thorough code reviews
-- Follow testing best practices
-- Manage releases with semantic versioning
-
-## Available Skills
-
-| Skill | Description | Triggers |
-|-------|-------------|----------|
-| `ai-collaboration-standards` | Prevent AI hallucination | Code analysis, "certainty" |
-| `checkin-assistant` | Pre-commit quality gates | "commit", "checkin", "quality gate" |
-| `commit-standards` | Conventional Commits format | "commit", git operations |
-| `code-review-assistant` | Systematic code review | "review", "PR" |
-| `testing-guide` | Testing pyramid | Writing tests |
-| `tdd-assistant` | Test-Driven Development | "TDD", "test first", "red green refactor" |
-| `bdd-assistant` | Behavior-Driven Development | "BDD", "Gherkin", "Given-When-Then" |
-| `atdd-assistant` | Acceptance Test-Driven Development | "ATDD", "acceptance criteria", "specification workshop" |
-| `release-standards` | Semantic versioning | Release preparation |
-| `git-workflow-guide` | Branching strategies | "branch", "merge" |
-| `documentation-guide` | Documentation structure & writing | "README", "docs", "ARCHITECTURE" |
-| `requirement-assistant` | Requirement writing | "requirement", "user story" |
-| `reverse-engineer` | Reverse engineer code to SDD specs | "reverse engineering", "legacy code", "code archaeology" |
-
-## Static vs Dynamic Standards | 靜態與動態規範
-
-Standards are classified into two types based on when they should be applied:
-
-規範依據應用時機分為兩類：
-
-### Static Standards (Project Files) | 靜態規範
-
-These standards should **always be active**. Add them to your project's `CLAUDE.md` or `.cursorrules`:
-
-這些規範應該**隨時生效**，建議放在專案的 `CLAUDE.md` 或 `.cursorrules` 中：
-
-| Standard | Key Rules | 核心規則 |
-|----------|-----------|---------|
-| [anti-hallucination](../../core/anti-hallucination.md) | Certainty labels, suggestion principles | 確定性標籤、建議原則 |
-| [checkin-standards](../../core/checkin-standards.md) | Build passes, tests pass, coverage met | 編譯通過、測試通過、覆蓋率達標 |
-| [project-structure](../../core/project-structure.md) | Directory structure conventions | 目錄結構規範 |
-
-> 📄 See [CLAUDE.md.template](../../templates/CLAUDE.md.template) for a ready-to-use template.
->
-> 📄 參見 [CLAUDE.md.template](../../templates/CLAUDE.md.template) 取得可直接使用的範本。
-
-### Dynamic Standards (Skills) | 動態規範
-
-These are **triggered by keywords** or specific tasks. Install as Skills:
-
-這些規範由**關鍵字觸發**，按需載入。安裝為 Skills 使用：
-
-| Skill | Trigger Keywords | 觸發關鍵字 |
-|-------|-----------------|-----------|
-| checkin-assistant | checkin, pre-commit, quality gate | 簽入, 品質關卡 |
-| commit-standards | commit, git, message | 提交, 訊息 |
-| code-review-assistant | review, PR, checklist | 審查, 檢查 |
-| git-workflow-guide | branch, merge, workflow | 分支, 合併 |
-| testing-guide | test, coverage, pyramid | 測試, 覆蓋率 |
-| tdd-assistant | TDD, test first, red green refactor | TDD, 測試優先, 紅綠重構 |
-| bdd-assistant | BDD, Gherkin, Given-When-Then, feature file | BDD, 行為驅動, 場景 |
-| atdd-assistant | ATDD, acceptance criteria, specification workshop | ATDD, 驗收條件, 規格工作坊 |
-| release-standards | version, release, semver | 版本, 發布 |
-| documentation-guide | README, docs, ARCHITECTURE, API docs | 文件, 架構, API 文件 |
-| requirement-assistant | spec, SDD, requirement | 規格, 需求, 新功能 |
-| reverse-engineer | reverse engineering, legacy code, code archaeology | 反向工程, 舊有程式碼, 規格提取 |
-
-> 📖 See [Static vs Dynamic Guide](../../adoption/STATIC-DYNAMIC-GUIDE.md) for detailed classification.
->
-> 📖 參見[靜態與動態指南](../../adoption/STATIC-DYNAMIC-GUIDE.md)了解詳細分類說明。
-
-## Slash Commands | 斜線命令
-
-> **Claude Code v2.1.3+ Note**: Slash commands and skills are now merged. Both `.claude/commands/review.md` and `.claude/skills/review/SKILL.md` create `/review` and work identically. Your existing `.claude/commands/` files continue to work.
->
-> **Claude Code v2.1.3+ 注意**：斜線命令與 Skills 已合併。`.claude/commands/review.md` 和 `.claude/skills/review/SKILL.md` 都會創建 `/review`，功能相同。現有的 `.claude/commands/` 檔案繼續運作。
->
-> **For other AI tools**: OpenCode, Roo Code, Gemini CLI and others still use the traditional commands format.
->
-> **其他 AI 工具**：OpenCode、Roo Code、Gemini CLI 等仍使用傳統的 commands 格式。
-
-In addition to automatic Skills, this plugin provides **manual slash commands** for explicit actions:
-
-除了自動觸發的 Skills，此插件還提供**手動斜線命令**用於明確的操作：
-
-| Command | Description | 說明 |
-|---------|-------------|------|
-| `/commit` | Generate commit messages | 產生 commit message |
-| `/review` | Perform code review | 執行程式碼審查 |
-| `/release` | Guide release process | 引導發布流程 |
-| `/changelog` | Update CHANGELOG | 更新變更日誌 |
-| `/requirement` | Write user stories | 撰寫用戶故事 |
-| `/spec` | Create specifications | 建立規格文件 |
-| `/tdd` | TDD workflow | TDD 工作流程 |
-| `/bdd` | BDD workflow | BDD 開發流程 |
-| `/atdd` | ATDD workflow | ATDD 驗收流程 |
-| `/docs` | Documentation | 文件撰寫 |
-| `/coverage` | Test coverage analysis | 測試覆蓋率分析 |
-| `/reverse-spec` | Reverse engineer to SDD spec | 反向工程成 SDD 規格 |
-| `/reverse-bdd` | Transform SDD AC to BDD scenarios | SDD AC 轉換為 BDD 場景 |
-| `/reverse-tdd` | Analyze BDD-TDD coverage | BDD-TDD 覆蓋率分析 |
-
-### Skills vs Commands | Skills 與命令的差異
-
-| Aspect | Skills | Commands |
-|--------|--------|----------|
-| **Trigger** | Automatic (context-based) | Manual (`/command`) |
-| **Use Case** | Background assistance | Explicit action |
-| **Example** | Claude suggests commit format | `/commit` to generate message |
-
-> 📖 See [commands/](./commands/) for detailed command documentation.
->
-> 📖 參見 [commands/](./commands/) 了解詳細的命令文件。
-
-## Installation
-
-### Recommended: Plugin Marketplace
-
-Install via Claude Code Plugin Marketplace for automatic updates:
-
-```bash
-# Add the marketplace (one-time setup)
-/plugin marketplace add AsiaOstrich/universal-dev-standards
-
-# Install the plugin with all 16 skills
-/plugin install universal-dev-standards@asia-ostrich
-```
-
-**Benefits:**
-- ✅ Automatic updates on Claude Code restart
-- ✅ Better integration with Claude Code
-- ✅ No manual maintenance required
-
-All skills will be automatically loaded and ready to use.
-
-### Alternative: Script Installation (Deprecated)
-
-> ⚠️ **Deprecated**: Manual installation via scripts is deprecated and will be removed in a future version. Please use Plugin Marketplace instead.
-
-For users in environments without Marketplace access (e.g., enterprise networks):
-
-#### Manual Install (Select Skills)
-
-**macOS / Linux:**
-```bash
-mkdir -p ~/.claude/skills
-cp -r ai-collaboration-standards ~/.claude/skills/
-cp -r commit-standards ~/.claude/skills/
-```
-
-**Windows PowerShell:**
-```powershell
-New-Item -ItemType Directory -Force -Path $env:USERPROFILE\.claude\skills
-Copy-Item -Recurse ai-collaboration-standards $env:USERPROFILE\.claude\skills\
-Copy-Item -Recurse commit-standards $env:USERPROFILE\.claude\skills\
-```
-
-### Alternative: Project-Level Installation (Deprecated)
-
-> ⚠️ **Deprecated**: Project-level manual installation is deprecated. Use Plugin Marketplace for the best experience.
-
-For project-specific skill customization:
-
-**macOS / Linux:**
-```bash
-mkdir -p .claude/skills
-cp -r /path/to/skills/claude-code/* .claude/skills/
-```
-
-**Windows PowerShell:**
-```powershell
-New-Item -ItemType Directory -Force -Path .claude\skills
-Copy-Item -Recurse path\to\skills\claude-code\* .claude\skills\
-```
-
-> **Note**: Project-level skills (`.claude/skills/`) take precedence over global skills (`~/.claude/skills/`).
-
-## Configuration
-
-Skills support project-specific configuration through `CONTRIBUTING.md`.
-
-### Disable Skills
-
-Add to your project's `CONTRIBUTING.md`:
-
-```markdown
-## Disabled Skills
-
-- testing-guide
-- release-standards
-```
-
-### Configuration Template
-
-See [CONTRIBUTING.template.md](CONTRIBUTING.template.md) for complete configuration options.
-
-## Skill Priority
-
-When the same skill exists in both locations:
-1. **Project level** (`.claude/skills/`) takes precedence
-2. **Global level** (`~/.claude/skills/`) is fallback
-
-## License
-
-Dual-licensed: CC BY 4.0 (documentation) + MIT (code)

package/bundled/skills/claude-code/commands/changelog.md

@@ -1,57 +0,0 @@
----
-description: Generate or update CHANGELOG following Keep a Changelog format
-allowed-tools: Read, Grep, Glob, Bash(git log:*), Bash(git tag:*), Bash(git diff:*)
-argument-hint: "[version number | 版本號]"
----
-
-# Changelog Assistant | 變更日誌助手
-
-Generate or update CHANGELOG.md following the Keep a Changelog format.
-
-依據 Keep a Changelog 格式產生或更新 CHANGELOG.md。
-
-## Workflow | 工作流程
-
-1. **Read existing CHANGELOG** - Parse current entries
-2. **Analyze commits** - Get commits since last version tag
-3. **Categorize changes** - Group by type (Added, Changed, etc.)
-4. **Generate entry** - Create new version section
-5. **Update file** - Insert new entry at top of Unreleased section
-
-## Change Categories | 變更類別
-
-| Category | Description | 說明 |
-|----------|-------------|------|
-| **Added** | New features | 新功能 |
-| **Changed** | Changes to existing features | 功能變更 |
-| **Deprecated** | Soon-to-be removed features | 即將移除 |
-| **Removed** | Removed features | 已移除 |
-| **Fixed** | Bug fixes | 錯誤修復 |
-| **Security** | Security vulnerability fixes | 安全修復 |
-
-## CHANGELOG Format | 格式
-
-```markdown
-## [Unreleased]
-
-### Added
-- New feature description
-
-### Fixed
-- Bug fix description
-
-## [1.0.0] - 2024-01-15
-
-### Added
-- Initial release
-```
-
-## Usage | 使用方式
-
-- `/changelog` - Update Unreleased section with recent commits
-- `/changelog 1.2.0` - Prepare changelog for specific version
-
-## Reference | 參考
-
-- Full standard: [changelog-guide](../../changelog-guide/SKILL.md)
-- Core guide: [changelog-standards](../../../../core/changelog-standards.md)

package/bundled/skills/claude-code/commands/derive-all.md

@@ -1,214 +0,0 @@
----
-description: Derive all test structures (BDD, TDD, ATDD) from approved SDD specification
-allowed-tools: Read, Write, Grep, Glob
-argument-hint: "<spec-file> [--lang <language>] [--framework <framework>] [--output-dir <dir>] [--dry-run]"
----
-
-# Derive All Test Structures from Specification | 從規格推演完整測試結構
-
-Generate complete test structures (BDD scenarios, TDD skeletons, ATDD acceptance tests) from approved SDD specification.
-
-從已批准的 SDD 規格生成完整測試結構（BDD 場景、TDD 骨架、ATDD 驗收測試）。
-
-## Workflow | 工作流程
-
-```
-┌─────────────────┐
-│  Read SPEC      │
-│  讀取規格        │
-└────────┬────────┘
-         │
-         ▼
-┌─────────────────┐
-│  Parse AC       │
-│  解析驗收條件    │
-└────────┬────────┘
-         │
-    ┌────┼────┬────────────┐
-    │    │    │            │
-    ▼    ▼    ▼            ▼
-┌──────┐ ┌──────┐ ┌──────┐ ┌──────────┐
-│ BDD  │ │ TDD  │ │ ATDD │ │ Summary  │
-│.feat │ │.test │ │.md   │ │ Report   │
-└──────┘ └──────┘ └──────┘ └──────────┘
-```
-
-## Anti-Hallucination Compliance | 反幻覺合規
-
-**CRITICAL**: All outputs MUST strictly follow 1:1 AC mapping.
-
-**關鍵**：所有輸出必須嚴格遵循 1:1 AC 對應。
-
-```
-Input:  SPEC with N Acceptance Criteria
-Output:
-  - Exactly N BDD Scenarios
-  - Exactly N TDD Test Groups
-  - Exactly N ATDD Test Tables
-
-If any output count ≠ input count → VIOLATION
-```
-
-## Steps | 步驟
-
-### 1. Read and Parse Specification | 讀取和解析規格
-
-Read the approved specification and extract:
-- SPEC metadata (ID, title, summary)
-- All Acceptance Criteria
-- AC format (GWT or bullet)
-
-### 2. Generate BDD Scenarios | 生成 BDD 場景
-
-Run `/derive-bdd` logic:
-- Transform each AC to Gherkin scenario
-- Apply @SPEC-XXX and @AC-N tags
-- Output to `features/SPEC-XXX.feature`
-
-### 3. Generate TDD Skeletons | 生成 TDD 骨架
-
-Run `/derive-tdd` logic:
-- Create describe blocks per AC
-- Add AAA structure with TODOs
-- Output to `tests/SPEC-XXX.test.{ext}`
-
-### 4. Generate ATDD Tables | 生成 ATDD 表格
-
-Run `/derive-atdd` logic:
-- Create test table per AC
-- Add step-by-step actions
-- Output to `acceptance/SPEC-XXX-acceptance.md`
-
-### 5. Generate Summary Report | 生成摘要報告
-
-Create derivation summary:
-- Files generated
-- AC coverage map
-- Next steps for implementation
-
-## Output Structure | 輸出結構
-
-```
-generated/
-├── features/
-│   └── SPEC-001.feature        # BDD scenarios
-├── tests/
-│   └── SPEC-001.test.ts        # TDD skeletons
-├── acceptance/
-│   └── SPEC-001-acceptance.md  # ATDD test tables
-└── DERIVATION-REPORT.md        # Summary report
-```
-
-### Derivation Report Format
-
-```markdown
-# Derivation Report for SPEC-001
-
-**Source**: specs/SPEC-001.md
-**Generated**: [timestamp]
-**Generator**: /derive-all v1.0.0
-
-## Summary
-
-| Metric | Value |
-|--------|-------|
-| Acceptance Criteria | N |
-| BDD Scenarios | N |
-| TDD Test Groups | N |
-| ATDD Test Tables | N |
-
-## Generated Files
-
-| File | Type | AC Coverage |
-|------|------|-------------|
-| features/SPEC-001.feature | BDD | AC-1, AC-2, AC-3 |
-| tests/SPEC-001.test.ts | TDD | AC-1, AC-2, AC-3 |
-| acceptance/SPEC-001-acceptance.md | ATDD | AC-1, AC-2, AC-3 |
-
-## AC Traceability Matrix
-
-| AC ID | BDD Scenario | TDD Test | ATDD Table |
-|-------|--------------|----------|------------|
-| AC-1 | ✓ Line 10 | ✓ Line 15 | ✓ AT-001 |
-| AC-2 | ✓ Line 20 | ✓ Line 35 | ✓ AT-002 |
-| AC-3 | ✓ Line 30 | ✓ Line 55 | ✓ AT-003 |
-
-## Next Steps
-
-1. [ ] Review generated BDD scenarios with stakeholders
-2. [ ] Fill [TODO] sections in TDD skeletons
-3. [ ] Execute ATDD acceptance tests manually
-4. [ ] Implement step definitions for BDD
-5. [ ] Start TDD Red-Green-Refactor cycle
-```
-
-## Parameters | 參數
-
-| Parameter | Description | Default |
-|-----------|-------------|---------|
-| `--lang` | Target language: ts, js, python, java, go | `typescript` |
-| `--framework` | Test framework | `vitest` |
-| `--output-dir` | Base output directory | `./generated` |
-| `--dry-run` | Preview without creating files | `false` |
-
-## Usage Examples | 使用範例
-
-```bash
-# Basic usage (all outputs)
-/derive-all specs/SPEC-001.md
-
-# With Python/pytest for TDD
-/derive-all specs/SPEC-001.md --lang python --framework pytest
-
-# Specify output directory
-/derive-all specs/SPEC-001.md --output-dir ./qa/generated
-
-# Preview without creating files
-/derive-all specs/SPEC-001.md --dry-run
-```
-
-## Integration with Workflow | 與工作流程整合
-
-After running `/derive-all`, the recommended workflow:
-
-執行 `/derive-all` 後的建議工作流程：
-
-```
-┌──────────────────────────────────────────────────────────────────┐
-│                    Post-Derivation Workflow                       │
-├──────────────────────────────────────────────────────────────────┤
-│                                                                  │
-│  1. Review BDD Scenarios                                         │
-│     └─→ Use /bdd to refine with Three Amigos                    │
-│                                                                  │
-│  2. Fill TDD [TODO] Sections                                     │
-│     └─→ Use /tdd to enter Red-Green-Refactor cycle              │
-│                                                                  │
-│  3. Execute ATDD Tests                                           │
-│     └─→ Manual testing with acceptance tables                   │
-│                                                                  │
-│  4. Implement Step Definitions                                   │
-│     └─→ Connect BDD scenarios to code                           │
-│                                                                  │
-│  5. Complete TDD Implementation                                  │
-│     └─→ Make all tests pass                                     │
-│                                                                  │
-└──────────────────────────────────────────────────────────────────┘
-```
-
-## Limitations | 限制
-
-This command **CANNOT**:
-
-此命令**無法**：
-
-- Generate outputs beyond AC count
-- Implement test logic automatically
-- Run any of the generated tests
-- Modify existing test files
-
-## Reference | 參考
-
-- Full skill guide: [forward-derivation](../forward-derivation/SKILL.md)
-- Core standard: [forward-derivation-standards.md](../../../core/forward-derivation-standards.md)
-- Individual commands: [derive-bdd](./derive-bdd.md), [derive-tdd](./derive-tdd.md), [derive-atdd](./derive-atdd.md)

package/bundled/skills/claude-code/commands/derive-atdd.md

@@ -1,177 +0,0 @@
----
-description: Derive ATDD acceptance test tables from approved SDD specification
-allowed-tools: Read, Write, Grep, Glob
-argument-hint: "<spec-file> [--output-dir <dir>] [--dry-run]"
----
-
-# Derive ATDD Acceptance Tests from Specification | 從規格推演 ATDD 驗收測試
-
-Generate ATDD acceptance test tables from approved SDD specification's Acceptance Criteria.
-
-從已批准的 SDD 規格驗收條件生成 ATDD 驗收測試表格。
-
-## Workflow | 工作流程
-
-```
-┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
-│  Read SPEC      │───▶│ Parse AC        │───▶│ Generate        │
-│  讀取規格        │    │ 解析驗收條件     │    │ Test Tables     │
-└─────────────────┘    └─────────────────┘    │ 生成測試表格     │
-                                              └────────┬────────┘
-                                                       │
-                                                       ▼
-                       ┌─────────────────┐    ┌─────────────────┐
-                       │  Manual Testing │◀───│ Write Acceptance│
-                       │  手動測試        │    │ Document        │
-                       └─────────────────┘    └─────────────────┘
-```
-
-## Anti-Hallucination Compliance | 反幻覺合規
-
-**CRITICAL**: Output MUST strictly follow 1:1 AC mapping.
-
-**關鍵**：輸出必須嚴格遵循 1:1 AC 對應。
-
-```
-Input:  SPEC with N Acceptance Criteria
-Output: Exactly N Acceptance Test tables
-
-If output count ≠ input count → VIOLATION
-```
-
-## Steps | 步驟
-
-### 1. Read Specification | 讀取規格
-
-Read the approved specification file and identify:
-- SPEC ID and title
-- Acceptance Criteria with IDs
-- Given-When-Then or bullet format
-
-### 2. Parse Acceptance Criteria | 解析驗收條件
-
-For each AC, extract:
-- Preconditions (Given)
-- Actions (When)
-- Expected outcomes (Then)
-
-### 3. Generate Test Tables | 生成測試表格
-
-For each AC, create:
-- Test case header with AC reference
-- Step-by-step action table
-- Expected result columns
-- Pass/Fail checkboxes
-- Tester sign-off section
-
-## Output Format | 輸出格式
-
-```markdown
-# SPEC-001 Acceptance Tests
-
-**Specification**: [SPEC-001](../specs/SPEC-001.md)
-**Generated**: [timestamp]
-**Status**: Pending
-
----
-
-## AT-001: [AC-1 Title]
-
-**Source**: AC-1 from SPEC-001
-**Priority**: High
-
-### Prerequisites
-- [Precondition from Given clause]
-
-### Test Steps
-
-| Step | Action | Expected Result | Pass/Fail |
-|------|--------|-----------------|-----------|
-| 1 | [Setup action] | [Ready state] | [ ] |
-| 2 | [User action from When] | [Intermediate result] | [ ] |
-| 3 | [Verification from Then] | [Expected outcome] | [ ] |
-
-### Test Data
-- [Required test data items]
-
-### Notes
-_______________
-
-### Sign-off
-- **Tester**: _______________
-- **Date**: _______________
-- **Result**: [ ] Pass / [ ] Fail
-
----
-
-## AT-002: [AC-2 Title]
-
-**Source**: AC-2 from SPEC-001
-**Priority**: Medium
-
-### Prerequisites
-- [Precondition from Given clause]
-
-### Test Steps
-
-| Step | Action | Expected Result | Pass/Fail |
-|------|--------|-----------------|-----------|
-| 1 | [Setup action] | [Ready state] | [ ] |
-| 2 | [User action from When] | [Intermediate result] | [ ] |
-| 3 | [Verification from Then] | [Expected outcome] | [ ] |
-
-### Sign-off
-- **Tester**: _______________
-- **Date**: _______________
-- **Result**: [ ] Pass / [ ] Fail
-
----
-
-## Summary
-
-| Test ID | Description | Status |
-|---------|-------------|--------|
-| AT-001 | [AC-1 Title] | [ ] Pending |
-| AT-002 | [AC-2 Title] | [ ] Pending |
-
-**Overall Result**: [ ] Pass / [ ] Fail
-**Approved By**: _______________
-**Date**: _______________
-```
-
-## Parameters | 參數
-
-| Parameter | Description | Default |
-|-----------|-------------|---------|
-| `--output-dir` | Output directory | `./acceptance` |
-| `--dry-run` | Preview without creating files | `false` |
-
-## Usage Examples | 使用範例
-
-```bash
-# Basic usage
-/derive-atdd specs/SPEC-001.md
-
-# Specify output directory
-/derive-atdd specs/SPEC-001.md --output-dir ./qa/acceptance
-
-# Preview without creating file
-/derive-atdd specs/SPEC-001.md --dry-run
-```
-
-## Limitations | 限制
-
-This command **CANNOT**:
-
-此命令**無法**：
-
-- Generate test tables beyond AC count
-- Execute the acceptance tests
-- Fill in test results automatically
-- Infer requirements not in specification
-
-## Reference | 參考
-
-- Full skill guide: [forward-derivation](../forward-derivation/SKILL.md)
-- Core standard: [forward-derivation-standards.md](../../../core/forward-derivation-standards.md)
-- ATDD workflow: [acceptance-test-driven-development.md](../../../core/acceptance-test-driven-development.md)