openreachtech/hora-core
openreachtech/hora-core has 56 GitHub stars and 0 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 04:22 UTC. Last push 2026-11-13.
計測したスター増加
- 24時間
- 0
- 7日間
- 更新が遅れています
- 15日間
- 更新が遅れています
- 1か月
- 更新が遅れています
期間ごとの純増数です。期間は重複しており、日別の値ではありません。未計測の値は空欄です。スター数は注目度の指標であり、品質の保証ではありません。
概要
Hora kit core modules
AIREADME.ja.md
オリジナルHora Kit
Hora は、仕様書からアプリケーションを、機能単位で、AI エージェントツールを通して実装します。
このパッケージは、そのコア — エージェントツールが読み込むスキルとエージェント — を、構築を行うリポジトリへ運ぶコンテナです。
新しいプロジェクトは、これを手で入れるものではありません。 出発点は GitHub テンプレートで、何を作るかによってどちらかを選びます。Web なら hora-boilerplate、ネイティブの Android / iOS なら hora-boilerplate-mobile です。どちらもこのパッケージと、そのスタックに要るスキルライブラリを依存として宣言し、npm install で配置し、キット全体のドキュメント — そのプロジェクトが何を持つか、各コマンドが何をするか、既存リポジトリへどう適用するか — を持っています。手法はどちらでも同じで、違うのはスタックと origin カタログ、そして行が装備するスキルライブラリです。以下に書かれているのは、どちらのテンプレート由来でもないリポジトリへキットを装備する場合の手順です。
同梱物はすべて単一のディレクトリ kit/ 配下にあり、エージェントツールが期待する配置をそのまま写しています。
kit/
├── agents/ サブエージェント定義
└── skills/ スキル定義
kit/ は特定のツール名ではなく、中身が何であるかに基づいて命名しています。そのため同じペイロードを、リポジトリが使うどのエージェントツールへも配置できます。本書がドキュメント化している対象は Claude Code で、その設定ディレクトリは .claude/ です。
npm が公開するのは dist/ で、パックのたびに kit/ から生成されます。両者の内容は同一なので、上の配置はそのままインストール後のパッケージの配置でもあります。
これに加えて、本パッケージは実行ファイルを 1 つ同梱しています。その役目は、上記のペイロードをリポジトリへ配置することだけです。インポートするものはありません。
Hora 自体の仕組み — このキットが運ぶ手法 — は docs/ にあります。クイックスタート、各コマンドの働き、オーケストレーターの走り方、既存リポジトリへの適用、緊急経路、並列経路、そしてこれらの文書が従う文章作法
インストール
Node.js 20.0.0 以降が必要です(package.json の engines が宣言している下限)。CI は現行の LTS でビルドしています。
npm install -D @openreachtech/hora
本パッケージ自身はインストールスクリプトを同梱していません。したがって依存に追加しても、パッケージが入るだけで、何も配置されません。プロジェクト自身の postinstall としてコマンドを宣言してください。それだけで、npm install がリポジトリをキットで武装させます。
{
"scripts": {
"postinstall": "hora-core install"
}
}
プロジェクト自身のスクリプトは、npm が v12 以降で差し止める対象の外にあります。したがって、そのプロジェクトをクローンする人に何も要求しません。ここで npx は不要です。ライフサイクルスクリプトは node_modules/.bin を PATH に入れて実行されるためです。
いま宣言したフックが効くのは、次の npm install からです。最初の配置は、コマンドを自分で実行してください。一度だけ配置したい場合や、フックを置けないリポジトリでも同じです。
npx --no hora-core install
--no は、ダウンロードの前で npx を止めます — 名前の解決はレジストリに問い合わせますが、取得はしないので、他人のパッケージの install スクリプトも bin も走りません。これが無いと、bin が入っていない状態は、このパッケージが持たない無スコープ名 hora-core で公開されたものの取得になります。
パッケージを依存に入れないまま実行する場合 — 一度だけの配置や、フックを置けないリポジトリ — は、名前を省略せずに指定してください。npx --package=@openreachtech/hora hora-core install が取得するのは、他人が公開できないスコープ付きの名前です。無スコープの bin 名には、その保証がありませんでした。
使い方
キットはリポジトリの .claude/ — エージェントツールが読み込むディレクトリ — へ配置されます。dist/agents/ は .claude/agents/ へ、dist/skills/ は .claude/skills/ へ。スキル探索が見るのはこのパスだけで、パッケージ自身のディレクトリは対象外です。つまり、このクローンがキットを可視化する唯一の手段です。以降、スキルは /hora、/hora-plan、/hora-build のようにスラッシュコマンドとして呼び出せます。
dist/ の各ディレクトリは同名のディレクトリへ運ばれ、そこに既にあるものはそのまま残ります。リポジトリが自作したスキルは、その名前が本パッケージの配布物と一致しない限り、インストール済みのものと並んで無傷で残ります。
リンクではなくディレクトリ
.claude/ と、その中の payload ディレクトリは、シンボリックリンクではなくリポジトリのディレクトリである必要があります。インストールは対象へ至る各段を検査し、いずれかがリンクであれば、何も書き込まず、何も削除せずに終了します。 インストール内容の記録である .hora/equip-core.json も同じように検査します。ここにリンクがあると、書き込みがリンク先へ届き、その中身を上書きしてしまうためです。
何も運ばなかったインストールは、その理由を告げ、0 以外の終了コードで終わります。プロジェクト自身の postinstall として実行しているなら、それは npm install の出力に現れます。単独で実行した場合は npx --no hora-core install が同じことを告げます。
リンクはコマンドを実行する人の指示ではなく、リポジトリの中身です。それを辿ると、エントリをどこへ書くか、そして前回のエントリをどこから消すかを、リポジトリ側が決められることになります。
.claude/ 全体をリポジトリ間で共有するディレクトリへ向けている場合は、そのディレクトリを直接名指ししてください。npx --no hora-core install --dir <解決先のディレクトリ> で同じ状態に到達し、リンクがある以上、キットは .claude/ から見えます。payload ディレクトリだけをリンクにしている場合、そこへインストールする方法はありません。--dir が指すのは payload を収めるディレクトリであって、payload そのものではないためです。実ディレクトリに置き換えてください。
インストール内容を最新に保つ
配置されたキットはリポジトリのソースではなく本パッケージのビルド成果物です。無視した上で、自分のものを名指しで戻してください。
.claude/agents/*
.claude/skills/*
!.claude/skills/my-own-skill/
.hora/*.json
.hora/wings/
.hora/addons/
名前の接頭辞ではなくディレクトリ全体で指定するのは意図的です。本パッケージの配布物はリリースごとに変わるため、今日の名前に合わせて書いたパターンは、何も告げずに古くなります。
.hora/ のうち無視するのは、installer が書くものだけです。本パッケージのインストール内容の記録である .hora/equip-core.json、その横にほかの installer が置く記録、そして add-on の installer が置く wing と定義です。どれも install のたびに作り直されます。.hora/ の残り — .hora/tasks/、.hora/addon/config.json など skill が書く記録 — はプロジェクトの状態なので、コミットします。
引数なしの npm install はプロジェクトの postinstall を再実行するので、キットも追従します。パッケージをコマンドラインで名指しする更新(npm install @openreachtech/hora@latest)では走りません。フックを置いていないリポジトリも同じです。その場合は、同じコマンドを再実行してください。
npx --no hora-core install
install は繰り返し実行できます。前回のインストール内容 — .hora/equip-core.json に記録されています — と、本パッケージが配布するエントリと同名のものを削除してから、現在のキットをコピーします。したがって、リネームされたスキルや削除されたスキルが残ることはありません。dist/ を手でコピーしていたリポジトリも、初回の実行で整理されます。
コマンド
| コマンド | 動作 |
|---|---|
hora-core install |
キットをインストールし、前回インストールしたものを置き換える |
hora-core list |
インストール対象のエントリを表示する。インストールは行わない |
hora-core uninstall |
本パッケージがインストールしたエントリとマニフェストを削除する |
hora-core help |
使い方を表示する |
--dir <path> を指定すると .claude 以外のディレクトリへインストールします。
コントリビューション
バグ報告・機能要望・コード貢献を歓迎します。
GitHub Issues からお気軽にご連絡ください。
git clone https://github.com/openreachtech/hora-core.git
cd hora-core
npm install
npm run lint
npm test
ライセンス
本プロジェクトは Apache License 2.0 で公開されています。
詳細は LICENSE ファイル を参照してください。
開発者
著作権
© 2026 Open Reach Tech Inc.