@nahisaho/satori 0.25.5 → 0.27.0

package/README.md

@@ -3,11 +3,12 @@
 **SATORI** は、科学データ解析のための **GitHub Copilot Agent Skills** コレクションです。
 
 [![npm version](https://img.shields.io/npm/v/@nahisaho/satori)](https://www.npmjs.com/package/@nahisaho/satori)
+[![CI](https://github.com/nahisaho/satori/actions/workflows/ci.yml/badge.svg)](https://github.com/nahisaho/satori/actions/workflows/ci.yml)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENCE)
 
 ## Overview
 
-このディレクトリには、Exp-01〜13 で蓄積した科学データ解析技法を Agent Skills として体系化した **190 個**のスキルを格納しています。Copilot がプロンプトの文脈に応じて適切なスキルを自動ロードし、各実験で確立した解析パターンを再利用します。131 のスキルは [ToolUniverse](https://github.com/mims-harvard/ToolUniverse) SMCP 経由で 1,200 以上の外部科学データベースツールとも連携可能です。
+このディレクトリには、Exp-01〜13 で蓄積した科学データ解析技法を Agent Skills として体系化した **190 個**のスキルを格納しています。Copilot がプロンプトの文脈に応じて適切なスキルを自動ロードし、各実験で確立した解析パターンを再利用します。全 190 スキルが [ToolUniverse](https://github.com/mims-harvard/ToolUniverse) SMCP 経由で 1,200 以上の外部科学データベースツールと連携可能です。
 
 ### パイプラインフロー
 
@@ -702,6 +703,18 @@ satori init
 
 `.github/skills/` がカレントディレクトリにコピーされ、Copilot Agent Mode で即座に利用できます。
 
+### CLI コマンド一覧
+
+| コマンド | 説明 |
+|---|---|
+| `satori init [--force] [--dry-run]` | `.github/skills/` をカレントディレクトリにインストール |
+| `satori pipeline suggest` | キーワードでインタラクティブにパイプラインを推薦 |
+| `satori pipeline list` | 全 26 ドメインパイプラインを一覧表示 |
+| `satori validate [--verbose]` | 全 190 SKILL.md を自動検証 |
+| `satori stats` | スキル数・TU カバレッジなどの統計表示 |
+| `satori help` | ヘルプ表示 |
+| `satori --version` | バージョン表示 |
+
 ---
 
 ## 使い方
@@ -979,6 +992,49 @@ Skills は `.github/skills/` に配置されているため、Copilot が自動
 
 ---
 
+## 開発
+
+### 前提条件
+
+- Node.js >= 18
+
+### セットアップ
+
+```bash
+git clone https://github.com/nahisaho/satori.git
+cd satori
+npm install
+```
+
+### テスト
+
+```bash
+npm test                  # 全テスト実行 (1,359 テスト)
+npm run test:unit         # CLI ユニットテストのみ (24 テスト)
+npm run test:validation   # SKILL.md 検証テストのみ (1,335 テスト)
+npm run test:coverage     # カバレッジ付き実行
+npm run test:watch        # ウォッチモード
+```
+
+### リント・フォーマット
+
+```bash
+npm run lint              # Biome lint チェック
+npm run lint:fix          # 自動修正
+npm run format            # コードフォーマット
+```
+
+### CI
+
+GitHub Actions で以下の 4 ジョブが `main` ブランチへの push / PR 時に実行されます:
+
+- **test**: Node.js 18/20/22 マトリクスでの全テスト実行
+- **validate-skills**: 全 SKILL.md フォーマット検証
+- **cli-smoke**: CLI コマンドのスモークテスト
+- **lint**: Biome によるコード品質チェック
+
+---
+
 ## 参考
 
 - [SATORI 使い方ガイド](../../docs/qiita-satori-guide.md)