adaptive-dev-workflowlisted
Install: claude install-skill hmj1026/dhpk
# Adaptive Dev Workflow
## Overview
本技能負責先做 workflow 分流,再決定是否需要 profile、scope、work-item、gate 這些前置資產。主 `SKILL.md` 只保留決策核心;重內容與專案特化資訊必須在符合條件時才漸進式載入。
## When NOT to Use
- CLAUDE.md Execution Policy 定義的 small change:直接 patch + dhpk:code-reviewer
- 已在進行 root-cause 調查:改用 `bug-investigation`
- 純架構設計或 module boundary 討論:改用 `software-architecture`
- OpenSpec change 已 apply-ready:直接切去 `/opsx:apply`
- 已進入 TDD 實作階段:改用 `test-driven-development`
## Core Principles
1. 先決定 workflow type,再決定要不要載入 heavy context。
2. 規範優先由專案權威文件驅動,例如 `CLAUDE.md`;技能只補 workflow 缺口。
3. `Lightweight Maintenance` 只做最小驗證,不建立 profile/scope/gate 重資產。
4. `Feature Delivery` / `Bug Investigation & Fix` 才能展開 profile、work-item、legacy、RED gate。
## Codex mode (opt-in)
本技能**預設 codex-free**——只用 Claude + dhpk agents,不需要 Codex CLI/MCP。傳入 `--codex` 才走
Codex 強化路徑(planning、實作、review 用 Codex 取得獨立第二意見)。若給了 `--codex` 但 Codex 不可用,
警告一次後 fall back 到 codex-free。
**隔離原則(重要):** 預設模式下**不得**呼叫任何 `mcp__codex__*` 工具;本技能的 `allowed-tools` 也
刻意不含 `mcp__codex__*`。Codex 只透過委派給專屬 `codex-*` command 取得(它們各自擁有該權限)。
下列每個 phase 在兩種模式下的對應:
| Phase | Codex-free(預設) | `--codex` |
|------|--------------------|-----------|
| Planning(跨模組 / DDD) | `dhpk:architect` agent | `/codex-architect` |
| Planning(根因未知) | `bug-investigation` skill | `/codex-brainstorm` 或 `code-investigate` |
| 實作 hand-off | `dhpk:bug-fix` / `dhpk:feature-dev` | 同上 `… --codex` |
| Test gate | `dhpk:tdd-guide` agent + `/check-coverage` | `/codex-test-review` |
| Review gate | `dhp