---

name: harness-setup description: "HAR: Project init, tool setup, agent config, memory setup, skill mirror sync. Trigger: setup, init, new project, CI/Codex setup, harness-mem, mirror. Do NOT load for: implementation, review, release, planning." description-en: "HAR: Project init, tool setup, agent config, memory setup, skill mirror sync. Trigger: setup, init, new project, CI/Codex setup, harness-mem, mirror. Do NOT load for: implementation, review, release, planning." description-ja: "HAR:プロジェクト初期化・ツール設定・エージェント構成・メモリ設定・skill mirror 同期を担当。セットアップ、初期化、新規プロジェクト、CI/Codex CLI セットアップ、harness-mem、mirror で起動。実装・レビュー・リリース・プランニングには使わない。" kind: workflow purpose: "Initialize and repair Harness project configuration" trigger: "setup, init, new project, CI/Codex setup, harness-mem, mirror" shape: workflow role: generator pair: harness-sync owner: harness-core since: "2026-05-05" allowed-tools: ["Read", "Write", "Edit", "Grep", "Glob", "Bash"] argument-hint: "[init|ci|codex|harness-mem|mirrors|agents|localize]" user-invocable: true effort: medium

Harness Setup

Harness の統合セットアップスキル。 以下の旧スキルを統合:

• setup — 統合セットアップハブ
• harness-init — プロジェクト初期化
• harness-update — Harness アップデート
• maintenance — ファイル整理・クリーンアップ

Quick Reference

サブコマンド	動作	詳細
/harness-setup init	新規プロジェクト初期化（CLAUDE.md + Plans.md + hooks + sync + doctor）	${CLAUDE_SKILL_DIR}/references/init.md
/harness-setup ci	CI/CD パイプライン設定	${CLAUDE_SKILL_DIR}/references/ci.md
/harness-setup codex	Codex CLI インストール・設定	${CLAUDE_SKILL_DIR}/references/codex.md
/harness-setup harness-mem	harness-mem 統合・メモリ設定	${CLAUDE_SKILL_DIR}/references/harness-mem.md
/harness-setup mirrors	skills/ → 公開 mirror bundle 更新	${CLAUDE_SKILL_DIR}/references/mirrors-agents-localize.md
/harness-setup agents	agents/ エージェント設定	${CLAUDE_SKILL_DIR}/references/mirrors-agents-localize.md
/harness-setup localize	CLAUDE.md ルールのローカライズ	${CLAUDE_SKILL_DIR}/references/mirrors-agents-localize.md
marketplace / update	Plugin install, update, dependency policy	${CLAUDE_SKILL_DIR}/references/marketplace.md
maintenance	ファイル整理・クリーンアップ	${CLAUDE_SKILL_DIR}/references/maintenance.md

Built-in slash discovery (CC 2.1.108+): /init のような built-in slash command も発見される。 Harness 固有の bootstrap が必要な時だけ /harness-setup init と使い分ける。

Claude Code setup guidance (CC 2.1.120+): MCP alwaysLoad、${CLAUDE_EFFORT}、claude plugin prune、claude project purge、 ANTHROPIC_BEDROCK_SERVICE_TIER、claude_code.skill_activated.invocation_trigger、 Windows PowerShell primary shell、forked skills / subagents の deferred tools は docs/claude-code-setup-mcp-telemetry-provider.md を正本として扱う。

Codex plugin workflows: Codex /goal と Plans.md を二重管理しない。 plugin-bundled hooks は opt-in、external agent import は ownership 明記、 MultiAgentV2 / agents.max_threads = 8 は上限として扱い、 sticky environments / app-server artifacts は safe default を優先する。 Codex 0.130.0 stable の codex remote-control、large thread pagination、 selected-environment view_image、live app-server config refresh、 accurate turn diffs、plugin details bundled hooks、sharing discoverability controls は docs/codex-plugin-workflows-policy.md を正本として扱う。 詳細は docs/codex-plugin-workflows-policy.md と ${CLAUDE_SKILL_DIR}/references/codex.md を参照。

Execution

状態確認だけの依頼は read-only の診断で完了する。setup 依頼は対象、望む状態、合格条件を既存設定と照合し、明示された surface の変更を進める。 不足情報は設定や契約を読み取りで回収する。任意機能を追加したり、対象外の設定や保護された設定を目的から推測して変更したりしない。

1. ユーザーの目的に対応する Quick Reference 行を選ぶ。
2. 該当する ${CLAUDE_SKILL_DIR}/references/*.md を読む。
3. 参照ファイルの手順に従い、dry-run がある操作は dry-run を先に実行する。
4. setup 後は必要に応じて harness doctor、bash scripts/sync-skill-mirrors.sh --check、bash scripts/ci/check-consistency.sh で確認する。

Upstream Policy Anchors

• docs/plugin-managed-settings-policy.md — plugin managed settings policy; normal defaults must not inherit managed marketplace restrictions.
• docs/codex-provider-setup-policy.md — Codex provider setup policy, including amazon-bedrock and model_provider = "amazon-bedrock" examples.
• Codex 0.123.0 以降の MCP diagnostics / plugin MCP loading guidance: use /mcp verbose and docs/codex-mcp-diagnostics.md for diagnostics.
• Codex sandbox / execution policy (0.123.0+): see docs/codex-sandbox-execution-policy.md for remote_sandbox_config and execution constraints.

Cursor 実装バックエンド導入

詳細手順は ${CLAUDE_SKILL_DIR}/references/cursor.md を読む。 契約アンカー: set-impl-backend.sh は AI 実行可。permissions.json、.cursorignore、*.cursor.sh allowlist はユーザー手動で、AI が編集できない protected path として扱う。 根拠ルールは .claude/rules/cursor-cli-only.md と docs/sandbox-allowlist-recipe.md。

Reference Index

• ${CLAUDE_SKILL_DIR}/references/init.md — init, Go binary verification, plugin sync, doctor.
• ${CLAUDE_SKILL_DIR}/references/ci.md — GitHub Actions CI setup.
• ${CLAUDE_SKILL_DIR}/references/codex.md — Codex CLI, provider/model metadata, app-server, MCP diagnostics, sandbox policy.
• ${CLAUDE_SKILL_DIR}/references/cursor.md — Cursor implementation backend setup and boundaries.
• ${CLAUDE_SKILL_DIR}/references/harness-mem.md — memory directory and template setup.
• ${CLAUDE_SKILL_DIR}/references/mirrors-agents-localize.md — mirror sync, agent setup, localization.
• ${CLAUDE_SKILL_DIR}/references/marketplace.md — plugin marketplace install/update and managed dependency policy.
• ${CLAUDE_SKILL_DIR}/references/maintenance.md — cleanup commands and related skills.

関連スキル

• harness-sync — 設定/Plans/git 状態の同期確認
• harness-work — 実装タスク実行
• harness-review — 品質レビュー
• maintenance — ファイル整理（統合済み）