| name | harness-setup |
| description | Harness v3 統合セットアップスキル。プロジェクト初期化・ツール設定・2エージェント構成・メモリ設定・公開 skill mirror 同期を担当。以下で起動: セットアップ、初期化、新規プロジェクト、CIセットアップ、codex CLIセットアップ、harness-mem、エージェント設定、symlink、mirror、harness-setup。実装・レビュー・リリース・プランニングには使わない。 |
| description-en | Unified setup skill for Harness v3. Project init, tool setup, 2-agent config, memory setup, and public skill mirror sync. Use when user mentions: setup, initialization, new project, CI setup, codex CLI setup, harness-mem, agent setup, symlinks, mirrors, harness-setup. Do NOT load for: implementation, code review, release, or planning. |
| description-ja | Harness v3 統合セットアップスキル。プロジェクト初期化・ツール設定・2エージェント構成・メモリ設定・公開 skill mirror 同期を担当。以下で起動: セットアップ、初期化、新規プロジェクト、CIセットアップ、codex CLIセットアップ、harness-mem、エージェント設定、symlink、mirror、harness-setup。実装・レビュー・リリース・プランニングには使わない。 |
| allowed-tools | ["Read","Write","Edit","Grep","Glob","Bash"] |
| argument-hint | [init|ci|codex|harness-mem|mirrors|agents|localize] |
| effort | medium |
Harness Setup (v3)
Harness v3 の統合セットアップスキル。
以下の旧スキルを統合:
setup — 統合セットアップハブharness-init — プロジェクト初期化harness-update — Harness アップデートmaintenance — ファイル整理・クリーンアップ
Quick Reference
| サブコマンド | 動作 |
|---|
harness-setup init | 新規プロジェクト初期化（CLAUDE.md + Plans.md + hooks） |
harness-setup ci | CI/CD パイプライン設定 |
harness-setup codex | Codex CLI インストール・設定 |
harness-setup harness-mem | harness-mem 統合・メモリ設定 |
harness-setup mirrors | skills-v3/ → 公開 mirror bundle 更新 |
harness-setup agents | agents-v3/ エージェント設定 |
harness-setup localize | CLAUDE.md ルールのローカライズ |
サブコマンド詳細
init — プロジェクト初期化
新規プロジェクトに Harness v3 を導入する。
生成ファイル:
project/
├── CLAUDE.md # プロジェクト設定
├── Plans.md # タスク管理（空テンプレート）
├── .claude/
│ ├── settings.json # Claude Code 設定
│ └── hooks.json # フック設定（v3 シム）
└── hooks/
├── pre-tool.sh # 薄いシム（→ core/src/index.ts）
└── post-tool.sh # 薄いシム（→ core/src/index.ts）
フロー:
- プロジェクト種別を検出（Node.js/Python/Go/Rust/その他）
- 最小限の CLAUDE.md を生成
- Plans.md テンプレートを生成
- hooks.json を配置
ci — CI/CD 設定
GitHub Actions ワークフローを設定する。
name: CI
on:
push:
branches: [main]
pull_request:
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npm ci && npm test
codex — Codex CLI 設定
which codex || npm install -g @openai/codex
TIMEOUT=$(command -v timeout || command -v gtimeout || echo "")
使用パターン:
${TIMEOUT:+$TIMEOUT 120} codex exec "$(cat /tmp/prompt.md)" 2>/dev/null
harness-mem — メモリ設定
Unified Harness Memory の設定を行う。
mkdir -p .claude/agent-memory/claude-code-harness-worker
mkdir -p .claude/agent-memory/claude-code-harness-reviewer
cat > .claude/agent-memory/claude-code-harness-worker/MEMORY.md << 'EOF'
[プロジェクト概要]
[学習パターン]
EOF
mirrors — 公開 skill bundle 同期
Windows の core.symlinks=false では repository symlink が通常ファイルになり、harness-* skill が command 一覧に出なくなることがあります。公開 bundle は実ディレクトリ mirror として同期します。
./scripts/sync-v3-skill-mirrors.sh
./scripts/sync-v3-skill-mirrors.sh --check
更新対象:
skills/codex/.codex/skills/opencode/skills/
agents — エージェント設定
agents-v3/ の3エージェント構成を設定する。
agents-v3/
├── worker.md # 実装担当（task-worker + codex-implementer + error-recovery）
├── reviewer.md # レビュー担当（code-reviewer + plan-critic）
└── scaffolder.md # 足場担当（project-analyzer + scaffolder）
localize — ルールローカライズ
.claude/rules/ のルールを現プロジェクトに適応する。
ls .claude/rules/
cat >> .claude/rules/project-rules.md << 'EOF'
[プロジェクト固有ルール]
EOF
Plugin インストール (v2.1.71+ Marketplace)
v2.1.71 で Marketplace の安定性が大幅に改善された。
推奨インストール方式
claude plugin install owner/repo@v3.5.0
claude plugin install owner/repo
owner/repo@vX.X.X 形式を推奨。@ref パーサー修正により、タグ・ブランチ・コミットハッシュいずれも正確に解決される。
アップデート
claude plugin update owner/repo
v2.1.71 で update 時の merge conflict が修正され、安定したアップデートが可能になった。
その他の改善点
- MCP server 重複排除: 同一 MCP サーバーの多重登録を自動防止
/plugin uninstall が settings.local.json を使用: ユーザーローカル設定に正確に反映
Maintenance — ファイル整理
定期メンテナンスタスク:
| タスク | コマンド |
|---|
| 古いログ削除 | find .claude/logs -mtime +30 -delete |
| Plans.md 圧縮 | 完了タスクをアーカイブセクションに移動 |
| 古いトレース削除 | tail -1000 .claude/state/agent-trace.jsonl > /tmp/trace && mv /tmp/trace .claude/state/agent-trace.jsonl |
関連スキル
harness-plan — セットアップ後にプロジェクト計画を作成harness-work — セットアップ後にタスクを実行harness-review — セットアップ設定をレビュー
