ja

ank をインストール

別々の作業が二つあります。ツール本体であるバイナリと、エージェントに使い方を教える skills です。自分のマシンに合う行を選び、続けて二つ目を実行してください。

1バイナリ

  • npm

    node が入っていればどのマシンでも。単体の実行ファイルはブロックするがレジストリは通すファイアウォールの内側では、この経路を使います。

    npm install -g @haksolot/ank

  • curl | sh

    Linux と macOS。アーカイブとその .sha256 を取得し、一致しなければ展開する前に中止します。

    curl -fsSL https://raw.githubusercontent.com/haksolot/ank/main/install.sh | sh

  • PowerShell

    Windows。Windows PowerShell 5.1 でも PowerShell 7 でも動きます。同じ検証を行い、実行中の ank.exe も置き換えられます。

    irm https://raw.githubusercontent.com/haksolot/ank/main/install.ps1 | iex

2Skills

すべてのエージェントにコマンド一つ。使っているエージェント（Claude Code、Codex、Cursor、OpenCode ほか三十種ほど）を検出し、それぞれを六つの skills の単一のコピーにリンクします。

npx skills add haksolot/ank

必要なもの

必要なのは二つ。ソースからビルドする場合だけ三つ目が要ります。

git 2.34 以降
便利だからではありません。claim は git の ref に保存され、ank は起動時にバージョンを確認します。
sh
verifier は 3 つの OS すべてで sh -c の下で動きます。Windows では Git for Windows に含まれているので、git があれば揃います。
Rust 1.95 以降
ソースからビルドする場合のみ。C コンパイラも必要です。

応答を確認する

どの経路で入れたにせよ、バイナリに自分が何者かを尋ねてください。

~
ank --version
ank 0.8.0 (8310e75, skill 0d916cc3d9a5)

ank update --check
running  0.8.0
latest   0.8.0
up to date

3 つの要素があり、それぞれがいつか抱く疑問への答えです。

バージョン0.8.0
何をインストールしたか。0.x なのは意図的です。ループと終了コードは仕様化済みですが、保存形式はまだです。
コミット8310e75
どのコミットからビルドされたか。手元のバイナリが、読んでいるドキュメントの挙動より古いのではと初めて疑ったときに効いてきます。
skill のリビジョンskill 0d916cc3d9a5
一緒にビルドされた skill。skill を読み込んだエージェントは、この文字列をツールの出力と比べて、自分の指示がバイナリより古いことに自分で気づけます。

アップデート

ank update --check は最新リリースを確認するだけで、何もインストールしません。ank update は、いま使っているバイナリを入れたのと同じ経路でインストールし、そのコマンドを先に表示します。skills には決して触れません。リビジョンが変わったときはそれを知らせ、再インストールはあなたに任せます。このためにネットワークへ出る動詞はほかにありません。

プラットフォーム

Linux、macOS、Windows。どの経路がどのマシンに対応しているかを正確に示します。

プラットフォームnpmcurl | shPowerShell
Linux x64
Linux arm64
macOS（Apple シリコン）
macOS（Intel）
Windows x64

npm パッケージにバイナリがない環境では、ラッパーが終了コード 9 で終了し cargo install を案内します。どのリリースにも含まれない環境では、curl | sh がプラットフォーム名を挙げて中止し、存在するものを一覧します。どちらも黙って失敗することはありません。

どれも合わないとき

リリースページには、2 つのインストーラーが取得するアーカイブがターゲットごとに .sha256 付きで置いてあります。手で展開するのは、インストーラーがやっていることそのものです。ソースツリーからもビルドできます。

cargo install --git https://github.com/haksolot/ank ank-cli

リリースページ

ank を配布しているパッケージマネージャーはありません。Homebrew、Scoop、apt、winget、AUR にはそれぞれチャネルや試みがありましたが、すべて取り下げられました。経路は 3 つだけで、どれもリポジトリから提供され、公開済みのリリースから作られています。

Skills

ただの markdown ファイルが 6 つ。最初のものはエージェントがデフォルトで読み込み、それ単体で完結します。残りの 5 つは一つずつ作業を受け持ち、必要になったときに読み込まれます。

ank
契約。ank がこの形をしている理由、使う場面ごとのコマンド、譲れないルール。
ank-plan
対話を通じて、目標を ADR、spec、タスクに落とし込む。
ank-drift
決定事項をコードと突き合わせて監査する。
ank-loop
バックログを自律的に進める。
ank-tdd
テストファーストで実装を進める。
ank-diagnose
不具合を原因までさかのぼる。

ほかの入れ方

どの経路も git にある同じ 6 つのファイルを指しています。誰かが手で同期し続けるコピーはありません。

  • Claude Code

    プラグインとして。中身は 6 つの skills だけです。エージェントも hook もサーバーもないので、自分で ank を呼ばない限り何も動きません。

    /plugin marketplace add haksolot/ank
/plugin install ank@ank

  • pi

    npm パッケージには skill とバイナリが同梱されています。pi はリソースを読み込むだけで ank を PATH に置かないので、バイナリも別途インストールしてください。

    pi install npm:@haksolot/ank

  • 手作業で

    skill/SKILL.md を、ハーネスが読み込む場所にコピーします。各 skill は生成部分のない 1 ファイルなので、失うものはありません。

インストールガイドの全文

ank をインストール

コマンドは二つ。Linux、macOS、Windows に対応し、git 2.34 以降が必要です。

npm install -g @haksolot/ank
npx skills add haksolot/ank
クイックスタートを読む