菜单
Diagnose the full harness environment. Reports external tool versions, gh auth status, user-project file presence, `_harness_version` drift, and runtime gitignore state in a single screen. Non-blocking — emits the report only. Usage: /harness:doctor
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
PRD generation rules and unified template enforced by a Python script. Single 14-section structure for Web, Backend, Mobile, and multi-platform projects.
ADR (Architecture Decision Record) generation + supersession rules. Immutable per-file under docs/adr/ (Status line is the only mutable surface). Bootstrap enumerates from PRD; standalone `/blueprint adr` adds or supersedes. Python-backed renderer.
Shared memory-management guidance for subagents. Preload via the subagent's skills frontmatter field so every agent follows the same rules about what to save, when to save, and when to retrieve.
Generate or update docs/ARCHITECTURE.md via a Python-backed, single unified template. Supports React Router Framework, Expo Router, NestJS, and Tauri 2 across single-package and monorepo layouts. The renderer enforces scope discipline — data model, features, code snippets, and tech-stack recommendations are rejected as PRD-territory.
Orchestrate creation/update of PRD, ADR, ARCHITECTURE, and ROADMAP via a guided 5-mode flow (Bootstrap / PRD / ADR / ARCHITECTURE / ROADMAP). Wraps the six doc subagents with phase-state enforcement so steps cannot be skipped. Use when the user invokes `/blueprint`, asks to "PRD/ROADMAP을 만들자", or wants to initialize/refresh project documentation.
Clean Architecture 4-layer dependency rules, TDD-exempt layer list, and test policy per layer. Reference-only skill preloaded by pipeline, tdd, code-reviewer, and other architecture-aware consumers.
| name | doctor |
| description | Diagnose the full harness environment. Reports external tool versions, gh auth status, user-project file presence, `_harness_version` drift, and runtime gitignore state in a single screen. Non-blocking — emits the report only. Usage: /harness:doctor |
| allowed-tools | ["Bash","Read"] |
Probes every prerequisite the plugin needs to operate and reports results to stdout as a table. Performs no automatic fixes — the user reads the report and decides what to act on.
PROJECT_DIR="${CLAUDE_PROJECT_DIR:-$PWD}"
PLUGIN_ROOT="${CLAUDE_PLUGIN_ROOT:-$PROJECT_DIR/.claude}"
TEMPLATES_DIR="$PLUGIN_ROOT/templates"
For each tool: install status + version (if present) + PATH.
| Tool | Command | Impact when missing |
|---|---|---|
jq | jq --version | blocking: every hook depends on jq |
git | git --version | blocking: version control unavailable |
python3 | python3 --version | PRD / ADR / ROADMAP / ARCHITECTURE generators disabled |
gh | gh --version | PR / Issue flow disabled |
bash | bash --version | head -1 | informational |
Additionally: if gh is present, run gh auth status and check for Logged in to.
| Item | Check |
|---|---|
CLAUDE.md | exists + extract _harness_version marker |
.claude/config.json | exists + extract _harness_version key |
.claude/runtime/ | exists (optional — auto-created on first task) |
.gitignore | contains .claude/runtime/ entry |
.claude/rules/ | code-style / file-conventions / review-finding-format files present |
TMPL_VER=$(jq -r '._harness_version // empty' "$TEMPLATES_DIR/config.json.tmpl" 2>/dev/null)
CFG_VER=$(jq -r '._harness_version // "unknown"' "$PROJECT_DIR/.claude/config.json" 2>/dev/null)
CLM_VER=$(grep -oE '_harness_version: [0-9]+\.[0-9]+\.[0-9]+' "$PROJECT_DIR/CLAUDE.md" 2>/dev/null \
| head -1 | awk '{print $2}')
Compare TMPL_VER against CFG_VER / CLM_VER — mismatch = drift.
=== Harness Doctor ===
Plugin: /Users/x/.claude/plugins/harness@tkstardev (templates v0.1.0)
Project: /Users/x/myproject
Tools:
jq 1.7.1 OK
git 2.43.0 OK
python3 3.11.7 OK
gh 2.40.1 OK (logged in as @username)
bash 5.2.21 OK
Files:
CLAUDE.md OK v0.1.0
.claude/config.json OK v0.1.0
.claude/runtime/ OK (gitignored)
.claude/rules/code-style.md OK
.claude/rules/file-conventions.md OK
.claude/rules/review-finding-format.md OK
Drift:
config.json v0.1.0 -> v0.1.0 OK
CLAUDE.md v0.1.0 -> v0.1.0 OK
Overall: OK
Per-item fix commands:
| Missing | Fix |
|---|---|
jq | macOS: brew install jq / Debian: apt install jq |
python3 | macOS: brew install python / Debian: apt install python3 |
gh | macOS: brew install gh / Debian: official GitHub CLI guide |
gh auth | gh auth login |
CLAUDE.md | /harness:init |
.claude/config.json | session restart (ensure-config.sh auto-runs) or cp .claude/templates/config.json.tmpl .claude/config.json |
| drift | /harness:update |
.claude/runtime/ not gitignored | session restart (ensure-runtime-gitignore.sh auto-runs) |