Sayknow-CLI 自律型コーディングエージェントのヒーローイラスト

Sayknow-CLI

コーディングは、考えることのように感じられるべきだ。
インタビュー、レビュー済みプラン、tmux ネイティブ実行、そして永続的な検証のための、集中型コーディングエージェントランナー。

Release License: MIT Stars Issues Built with Bun i18n

English · 한국어 · 中文 · 日本語 · Español · Français · Deutsch

Sayknow-CLI キャラクターマスコット

> Sayknow-CLI は実験的なベータ段階のプロジェクトです。粗削りな部分があることを想定し、重要な作業で頼る前には出力を検証してください。 ## Languages インターフェースは **7 言語** にローカライズされています — English、한국어 (韓国語)、 中文 (简体 / 簡体字中国語)、日本語 (Japanese)、Español (スペイン語)、 Français (フランス語)、そして Deutsch (ドイツ語)。初回起動時にシステムロケールを 自動検出します。**Settings → Appearance → Language** でいつでも切り替えられるほか、 たとえば `LANG=ja_JP.UTF-8 skc` のように起動することもできます。未翻訳の文字列は英語に フォールバックし、ブランド名や技術名 (Claude、OpenAI、MCP、…) はすべてのロケールで そのまま表示されます。 ## Sayknow-CLI とは? Sayknow-CLI (`skc`) は外部コーディングエージェントのハーネスです。選択したリポジトリまたは worktree から実行され、エージェントに対して小さく明示的なワークフロー面を提供します: ```text deep-interview -> ralplan -> ultragoal └─ optional team execution when parallel tmux workers help ``` これは意図的に、Codex CLI、Claude Code、OpenCode、Claw Code 向けの隠しプラグインにはなっていません。構造化されたプランニング、永続的なエビデンス、tmux ベースのワーカー、または分離された worktree が欲しいときに、それらのツールと並べて `skc` を起動してください。 ## Install ```sh npm install -g sayknow-cli # または: bun install -g sayknow-cli skc --version ``` macOS・Linux・Windows 向けのビルド済みネイティブを同梱しているため、Rust ツールチェーンやビルド手順は不要です。更新は `npm install -g sayknow-cli@latest`、またはターミナルで `skc update`。 > 以前ソース(git clone)からインストールした場合は、一度だけ `rm -f ~/.local/bin/skc && npm install -g sayknow-cli` で切り替えてください。ソース/開発インストールは[英語版 README](../../README.md#install-from-source-development)を参照。 ## Quick start ```sh # Run directly in the current checkout skc # Use a tmux-backed leader session skc --tmux # Use an isolated worktree for risky or reviewable work # --worktree takes an optional branch-like name, not a filesystem path. skc --tmux --worktree my-task-branch # If you already created a worktree directory, launch from that directory instead. cd ../my-task-worktree && skc --tmux ``` SKC セッション内では、公開されているワークフロー面を使用してください: ```text /skill:deep-interview clarify ambiguous requirements /skill:ralplan build and critique the implementation plan skc ultragoal create-goals --brief-file skc ultragoal complete-goals ``` `skc team ...` は、協調する tmux ワーカーが実質的に役立つときにのみ追加してください。 ## Core capabilities - **推測する前にインタビューする**: `deep-interview` は曖昧なリクエストを具体的な要件に変えます。 - **変更する前にプランニングする**: `ralplan` はコード変更の前にアプローチをレビューします。 - **エビデンスとともに実行する**: `ultragoal` はゴール、リビジョン、チェック、完了エビデンスを追跡します。 - **役立つときに並列化する**: `team` はより大きなタスクのために tmux ベースのワーカーを協調させます。 - **外部かつレビュー可能であり続ける**: 別のエージェントランタイムにパッチを当てることなく、選択したリポジトリまたは worktree から実行します。 - **プロバイダーが失敗しても作業を続ける**: デフォルトモデルがブロックされたとき (認証情報なし、クォータ超過、認証エラーやサーバーエラー)、セッションは別プロバイダーのモデルで続行します。このチェーンは `/fallback` で確認・編集できます。再起動や一時的な障害で中断したステップは、同じモデルで一度だけ自動的に再開します。Z.AI `1113` のようなクォータ応答では、リトライバジェットを使い果たさずに 1 回のリクエストで次へ進みます。 - **長いセッションでもコンテキストウィンドウに収める**: コンパクション後、Codex は `context_length_exceeded` に向かって膨らみ続けるのではなく、プロバイダーから見える新しいベースラインから再開します。また、コンパクションの要約はプロバイダーに拒否されない表現で書かれます。 - **意味でコードを探す**: `locate` ツールは、grep する名前がなくても、平易な説明から該当する振る舞いがどこにあるかを見つけます。 - **作業を適切なモデルに振り分ける**: `/model` でロールごと、さらに詳細な用途ごとにモデルを割り当てます。サブエージェントのタスクは `specialty` を宣言し、その種類の作業用に選んだモデルで実行されます。 - **セッションを離れずにシップする**: `github` と `gitlab` ツールで、SKC から離れることなくプル/マージリクエストを作成・確認し、CI も確認できます。 - **テストがこのコードで実行されたことを証明する**: `verification-receipts` プラグインはテスト実行ごとにレシートを保存し、その後コードが変更されたら知らせます。 - **どのセッションにも戻れる**: `alt+r` の再開ピッカー、最新のセッションを続ける `ctrl+q`、`/star`、`/fork`、`/rename`、そして Codex と Claude Code のトランスクリプトを取り込む `/import-session`。 ## Workflow surface Sayknow-CLI は 4 つのデフォルトワークフロースキルを同梱しています: | Skill | What it does | | ---------------- | --------------------------------------------------------------------- | | `deep-interview` | プランニングやコード変更の前に、曖昧な要件を明確化します。 | | `ralplan` | 変更の前に実装プランを構築し批評します。 | | `ultragoal` | 実行、リビジョン、検証、エビデンスを通じてゴールを追跡します。 | | `team` | 並列実行に価値があるときに tmux ベースのワーカーを協調させます。 | そして 4 つの同梱ロールエージェント: | Agent | What it does | | ----------- | -------------------------------------------------- | | `executor` | 範囲を限定した実装、修正、リファクタリング。 | | `architect` | 読み取り専用のアーキテクチャおよびコードレビュー評価。 | | `planner` | 読み取り専用のシーケンシングと受け入れ基準。 | | `critic` | 読み取り専用のプラン批評と実行可能性レビュー。 | 肥大化したデフォルトスキルの動物園はありません: SKC はこの小さなメソッドをより良くすることで改善されます。 ## Built-in tools エージェントは以下のツールを通じて作業します。*opt-in* と記されたツールは、**Settings → Tools** (または `~/.skc/config.yml` の該当キー) で有効にするまでオフのままです。 | Area | Tools | | ---- | ----- | | ファイルとコード | `read`、`write`、`edit`、`find`、`search`、`locate` (説明からコードを探す)、`ast_grep` / `ast_edit` (構文を理解した検索と書き換え)、`lsp` | | シェルとランタイム | `bash`、`eval` (JS/Python セル)、`ssh`、`debug`、`bisect`、`calc` | | 委任とトラッキング | `task` (サブエージェント)、`subagent`、`job`、`monitor`、`cron`、`irc` (実行中のエージェントと会話)、`todo_write`、`goal`、`checkpoint` / `rewind` | | Git ホスティング | `github` (*opt-in*、`github.enabled`): `gh` を通じたプルリクエスト、プッシュ、CI 実行 · `gitlab` (*opt-in*、`gitlab.enabled`、[`glab`](https://gitlab.com/gitlab-org/cli) が必要): `mr_create` (重複を作らず、既にオープンな MR を返す)、`mr_view`、`mr_list`、`ci_status`。gitlab.com とセルフホストのインスタンスに対応 | | Web とデバイス | `web_search`、`browser`、`computer`、`render_mermaid` | | ディスカバリー | `search_tool_bm25` (非表示ツールや MCP ツールを必要に応じて有効化)、`skill`、`skill_discovery`、`ask` | 1 回の実行で使うツールセットは `--tools read,bash,...` で選べます。プラグイン、カスタム、MCP のツール名もここで指定できます。 ## Plugins SKC はプラグインバンドル (ツール、フック、スキル、MCP サーバー) を読み込みます。バンドルはインストール時にハッシュで検証され、その後ファイルが変更されると隔離されます。管理には `skc plugin install|list|...` を使います。 **`verification-receipts`** (このリポジトリに同梱) は「今あるコードで、テストは本当に通ったのか?」に答えます: - `verification_run` は指定したテストファイルを `bun test` または `node --test` で実行し、変更不可のレシートを保存します: ファイルごとの成功/失敗件数と、作業ツリーのフィンガープリントです。 - `verification_status` はテストを再実行せずにそのフィンガープリントを再計算し、`fresh` か、コードが変更されて `stale` になったかを報告します。 - `verification_loop` とそのフックは、バックグラウンドの `task` が最新のレシートなしで終了したときに知らせます。 これは参考情報を示すだけ (advisory) で、POSIX 専用です。`node --test` には Node 24.11.1+ が必要です。npm パッケージには含まれないため、チェックアウトからインストールしてください: ```sh git clone https://github.com/jaybeyond/Sayknow_CLI.git skc plugin install ./Sayknow_CLI/packages/coding-agent/bundles/verification-receipts --user ``` ## Works beside your existing agent or bot | Tool or bot | Recommended SKC command | Boundary | | ----------- | ----------------------- | -------- | | Codex CLI | `skc --tmux --worktree ` or `skc` | `--worktree` は SKC が管理する兄弟 worktree に名前を付けます。既存のパスを使う場合は、まずそこへ `cd` してください。 | | Claude Code | `skc --tmux` or `skc --tmux --worktree ` | SKC は Claude Code の拡張機能にはなりません。 | | OpenCode | `skc` or `skc --tmux` | 現時点では外部ランナーのワークフローのみです。 | | Claw Code | `skc --tmux --worktree ` | SKC は Claw Code にインストールされたり、置き換えたりはしません。 | | External controller / bot | `skc mcp-serve coordinator` plus `skc setup hermes` for compatible config, or `skc --mode rpc` for a subprocess worker | MCP/RPC 対応のボットはどれも、スクロールバックのスクレイピングではなく、汎用のコーディネーター/RPC コントラクトを通じて SKC を駆動します。 | 汎用的なサードパーティボットのセットアップとプロバイダー非依存のスモークテストについては、[`docs/bot-integration.md`](docs/bot-integration.md) を参照してください。MCP、RPC、ACP、Bridge/HTTPS 各面にわたる準備状況の分類については、[`docs/external-control-readiness.md`](docs/external-control-readiness.md) を参照してください。より低レベルのプロトコル詳細については、[`docs/hermes-mcp-bridge.md`](docs/hermes-mcp-bridge.md)、[`docs/rpc.md`](docs/rpc.md)、および [`docs/bridge.md`](docs/bridge.md) を参照してください。リモートオペレーター面のロードマップについては、[`docs/sayknow-remote.md`](docs/sayknow-remote.md) (web steering wheel) と [`docs/telegram-remote.md`](docs/telegram-remote.md) (Telegram lifecycle button) を参照してください。 ## Configuration プロバイダーのリトライ、再開、フォールバックの動作は `~/.skc/config.yml` で設定します (以下の値がデフォルトです): ```yaml retry: requestMaxRetries: 4 streamMaxRetries: 100 maxRetries: 3 maxDelayMs: 300000 autoResume: true # 中断したステップを同じモデルで一度だけ再開 maxSilentTimeouts: 3 # 出力のないタイムアウトがこの回数に達したら停止 fallback: auto: true # デフォルトモデルがブロックされたら、ログイン済みの別プロバイダーで続行 maxAttempts: 3 # チェーン内の次のモデルへ移る前の、モデルごとの試行回数 ``` `requestMaxRetries` はストリームが確立される前に適用されます。`streamMaxRetries` はリプレイ安全な一時的ストリーム障害にのみ適用されます。無効な認証、サポートされていないモデル/プロバイダー、不正な形式のリクエスト、コンテキストオーバーフロー、ユーザーによる中断、および恒久的なクォータ障害は、現在のモデルで即座に失敗 (フェイルファスト) します。`fallback.auto` が有効な場合、ブロックされたデフォルトモデルはチェーン内の次のモデルに引き継がれます (`/fallback` で確認・編集できます)。 ## TUI identity デフォルトの TUI アイデンティティは SKC の **ink-octopus** テーマ — タコの墨: 温かみのあるグラファイト、紙色の文字、琥珀色のアクセント 1 色 — でダークターミナルに適用され、ライトターミナルには **blue-octopus** が適用されます。より暗めでハイコントラストなパレットを好む人のために、温かみのある **red-octopus** バリアントも同梱されています。さらに 3 つの移行用テーマ — `claude-code`、`codex`、`opencode` — がそれらのツールの見た目を再現しており、視覚的な移行を容易にし、Settings または `/theme` から選択できます。ユーザーが明示的に設定したテーマは引き続き優先されます。 ### Bundled theme grid Settings (`Appearance -> Dark theme` / `Light theme`) または `/theme` から選択してください。 | Theme | Visual feel | Best fit | | --- | --- | --- | | `blue-octopus` | テンタクルブルーのアクセントを持つ青いタコのパレット。 | ライトターミナルのデフォルト。 | | `red-octopus` | 強いステータスコントラストを持つ温かみのある赤いタコのバリアント。 | ハイコントラストなダークの代替。 | | `ink-octopus` | タコの墨 — 温かみのあるグラファイト背景、紙色の文字、琥珀色のアクセント 1 色。 | ダークターミナルのデフォルト。 | | `glow-octopus` | 深海の生物発光 — ティールがかった黒に発光グリーン、サブにバイオレット。 | 鮮やかなアクセントが欲しいダークターミナル。 | | `violet-octopus` | プラム色のダークにラベンダーのアクセント、サブにアプリコット。 | 柔らかくカラフルなダークの代替。 | | `claude-code` | テラコッタとピンクのハイライトを持つ Claude Code 風のダークパレット。 | SKC を離れずに Claude Code の体に染み付いた操作感を。 | | `codex` | よりシャープなコーディングセッションのコントラストを持つ、くっきりしたダークブルーグレーのパレット。 | Codex ライクなダークワークスペース。 | | `opencode` | よりパンチの効いたターミナルアクセントを持つ OpenCode 風のダークパレット。 | 同梱のピッカーで OpenCode の体に染み付いた操作感を。 | ## Development 依存関係をインストールし、ネイティブバインディングをビルドし、ローカルのデフォルトをセットアップします: ```sh bun install bun run build:native bun run install:defaults ``` `@sayknow-cli/natives` 用の `.node` バイナリは gitignore されており、あらゆる CLI 呼び出し (`install:defaults`、`dev:link`、テスト) の前に必要です。 ### Canonical: build and link the dev `skc` グローバルの `skc` コマンドが **このチェックアウトの TypeScript ソース** を実行するようにする (すべての編集に即座に反映され、スキル/ネイティブが動作する) には、それをあなたの `PATH` にリンクします: ```sh bun install bun run dev:link ``` `dev:link` は `skc` → `packages/coding-agent/src/cli.ts` を `~/.local/bin` にシンボリックリンクし (`SKC_DEV_LINK_DIR` で上書き可能)、その管理対象ターゲットを置き換え、別の `skc` が `PATH` 上でより前にそれをシャドウしている場合は警告して失敗し、`--smoke-test` を実行して `@sayknow-cli/natives` がロードされることを確認します。完全なブートストラップ (install + link + `setup defaults`) には `bun run install:dev` を使用してください。 あなたの `skc` がドリフトしていないか (誤ったソース、またはスキルをロードできないコンパイル済みバイナリ) は、いつでも確認できます: ```sh bun run dev:doctor ``` > 日常の開発にコンパイル済みバイナリを **使わないでください**。`bun --cwd=packages/coding-agent run build` はスタンドアロンの `dist/skc` を生成しますが、`bun build --compile` のバイナリは `@sayknow-cli/natives` を動的にロードできないため、スキルは `Cannot find module '@sayknow-cli/natives' from '/$bunfs/root/skc'` で失敗します。`dev:link` を通じてソースから実行すれば、これを回避できます。バイナリのビルドはリリースを検証するときのみ行ってください。 リンクせずに CLI をソースから直接実行します: ```sh bun packages/coding-agent/src/cli.ts --help ``` デフォルトのワークフロー定義はソースにあり、コミットされた `.skc` のコピーにはありません: ```text packages/coding-agent/src/defaults/skc/skills//SKILL.md packages/coding-agent/src/prompts/agents/.md ``` ワークフロー定義またはリブランド面の変更については、プロジェクトのゲートを実行してください: ```sh bun scripts/check-visible-definitions.ts bun scripts/verify-g002-gates.ts bun scripts/rebrand-inventory.ts --strict bun test packages/coding-agent/test/default-skc-definitions.test.ts ``` パッケージごとのマップについては、[`docs/codebase-overview.md`](docs/codebase-overview.md) を参照してください。 ## Contributors コントリビューション、バグレポート、リリース検証は GitHub の Issues と Pull Request を通じて歓迎しています。 ## Inspirations and lineage Sayknow-CLI のデフォルト TUI アイデンティティはタコのファミリーです: ダークのデフォルト ink-octopus、ライトのデフォルト blue-octopus、そして red-octopus・glow-octopus・violet-octopus の代替。また、`claude-code`、`codex`、`opencode` の移行用テーマも同梱しており、これらのパレットはそれらのツールにインスパイアされているため、移行してくるユーザーが見慣れた見た目を得られます。これは、公開された SKC 面を意図的に集中させたまま、小さなエージェントハーネス一族からの教訓の上に構築されています。歴史的な帰属表示は [`NOTICE.md`](NOTICE.md) に保持されています。 ## License MIT。[`LICENSE`](LICENSE) を参照してください。