菜单
Alt スタックを Docker Compose で操作する。サービスの起動・停止・再ビルド・ログ確認・health check、18 個の stack ファイルに分割された構成のどこにどのサービスが居るかの引き当て、起動しない/変更が反映されない/ポート衝突の切り分けを扱う。ユーザが「起動して」「ログ見せて」「再ビルドして」「立ち上がらない」のようにコンテナ操作を求めたとき、または compose 配下の yaml を編集するときに使う。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
Drive Alt changes test-first in outside-in order — E2E (Playwright/Hurl) → CDC (Pact) → Unit (RED-GREEN-REFACTOR) — and close with a local CI parity sweep (format/lint/type/security) for every touched microservice. Use when implementing a feature, fixing a bug, or refactoring, when deciding what test to write first, or when the user says "TDDで". Also use before declaring work complete, since "tests pass" is not "CI will pass".
Alt の Architecture Decision Record を日本語で `docs/ADR/NNNNNN.md` に書き起こす。番号採番、frontmatter（title/date/status/tags/affected_services/aliases/supersedes）、Context・Decision・Consequences の書き分け、wikilink 形式、OSS 公開向けの情報衛生を扱う。実装が一段落して決定を記録するときに使う。ユーザが「ADR書いて」「ADRにまとめて」「ADRに記録して」「実装が終わったのでドキュメントに」と言ったとき、または設計上の判断を伴う変更を終えたときに使う。
Interrogate a plan against the project's documented decisions and domain language — challenging fuzzy terms, cross-referencing the code, and surfacing where the plan contradicts an existing ADR or canonical contract. Use when the user wants a plan stress-tested against what the project has already decided, rather than in the abstract. Prefer plain grill-me when there is no documented model to test against, and plan-context-loader when the goal is to gather vault context rather than be questioned.
Hunt for deepening opportunities — shallow modules whose interface costs as much to learn as their implementation saves — and present them as a visual before/after report, informed by the decisions already recorded in docs/ADR/. Use when the user wants to improve architecture, find refactoring opportunities, consolidate tightly-coupled modules, reduce the cost of understanding a subsystem, or make code more testable. Use clean-architecture instead when the question is whether a specific change violates Alt's layer rules.
設計・計画タスク時に、Obsidian vault から関連 ADR・contract・review・runbook を 必要最小限だけ集めて計画の精度を上げる。 次のときに使う: - 「計画を立てて」「設計して」「プランを作って」 - ADR や過去の決定を確認したい - Knowledge Trail / Knowledge Home や reproject-safe / immutable 設計が絡む
Alt の Go 規約を適用する。エラーラップ、context 第一引数、slog、テーブル駆動テスト、http.Server の 4 タイムアウト、Redis Streams の XACK/XAUTOCLAIM 対、fail-fast 設定を扱う。Go のコードを書く・直す・レビューするときに使う。ユーザが「Go」や規約名に触れなくても、Go サービス（alt-backend, auth-hub, pre-processor, search-indexer, mq-hub, rag-orchestrator, altctl）の実装・修正に入るなら使う。
| name | docker-compose |
| description | Alt スタックを Docker Compose で操作する。サービスの起動・停止・再ビルド・ログ確認・health check、18 個の stack ファイルに分割された構成のどこにどのサービスが居るかの引き当て、起動しない/変更が反映されない/ポート衝突の切り分けを扱う。ユーザが「起動して」「ログ見せて」「再ビルドして」「立ち上がらない」のようにコンテナ操作を求めたとき、または compose 配下の yaml を編集するときに使う。 |
| allowed-tools | Bash, Read, Glob, Grep |
| argument-hint | [service] [up|down|logs|ps|restart] |
| paths | ["compose/**"] |
Alt は Compose を single source of truth とする。K8s は使わない。
-f compose/compose.yaml -p alt は常に付ける。省略すると別プロジェクト扱いになり既存コンテナを見失う。
docker compose -f compose/compose.yaml -p alt up -d # 全体
docker compose -f compose/compose.yaml -p alt up -d <service> # 単体
docker compose -f compose/compose.yaml -p alt up --build -d <service> # コード変更後
docker compose -f compose/compose.yaml -p alt logs <service> -f
docker compose -f compose/compose.yaml -p alt ps
docker compose -f compose/compose.yaml -p alt down
include:）compose/compose.yaml が 18 個の stack ファイルを include: する。profile ではないので --profile は使わない。
サービス名からどのファイルを編集すべきかを引く表:
| Stack file | Services |
|---|---|
db.yaml | db, meilisearch, clickhouse, pre-processor-db, pre-processor-db-migrator |
core.yaml | plecto-proxy, alt-frontend-sv, alt-backend, migrate |
bff.yaml | alt-butterfly-facade |
auth.yaml | kratos-db, kratos-migrate, kratos, auth-hub |
workers.yaml | pre-processor-sidecar, search-indexer, tag-generator, oauth-token-init, auth-token-manager |
ai.yaml | redis-cache, news-creator-backend, news-creator, news-creator-volume-init, pre-processor |
mq.yaml | redis-streams, mq-hub |
rag.yaml | rag-db, rag-db-migrator, rag-orchestrator, knowledge-embedder-local, rerank-local |
recap.yaml | recap-db, recap-db-migrator, recap-worker, recap-subworker, dashboard, recap-evaluator |
acolyte.yaml | acolyte-db, acolyte-db-migrator, acolyte-orchestrator |
sovereign.yaml | knowledge-sovereign-db, knowledge-sovereign-db-migrator, knowledge-sovereign |
logging.yaml | rask-log-aggregator と各サービスの *-logs forwarder |
observability.yaml | prometheus, grafana, cadvisor |
pki.yaml | step-ca, step-ca-bootstrap, pki-agent-<親サービス> 群 |
pgbouncer.yaml | pgbouncer, pgbouncer-kratos |
pact.yaml | pact-db, pact-broker |
perf.yaml | alt-perf, k6 |
backup.yaml | docker-socket-proxy, restic-backup |
curl http://localhost/health # Frontend (nginx 経由)
curl http://localhost:9000/v1/health # alt-backend
curl http://localhost:9250/health # BFF (alt-butterfly-facade)
curl http://localhost:7700/health # Meilisearch
環境固有で、素直に推測すると外す点。
restart は host port を再 bind しない。 bind に失敗したコンテナは --force-recreate が必要で、restart では直らないnetwork_mode: service: の pki-agent サイドカーは親と同時に recreate する。 親だけ再作成すると相乗りサイドカーが孤立し、無言で壊れる。--force-recreate <親> pki-agent-<親> と並べて指定する--build が必須。 付け忘れると古いバイナリが動き続け、「変更が反映されない」の原因になるdown してから up -d。 中途半端な状態からの up は依存解決に失敗しやすいdocker ps で占有コンテナを先に特定する