diff --git a/README.md b/README.md index 1425b2c..41fdb75 100644 --- a/README.md +++ b/README.md @@ -15,6 +15,7 @@ 📋 看板功胜 · 📚 架构文档 · English · + 日本語 · 参䞎莡献

diff --git a/README_EN.md b/README_EN.md index 106493b..5754a44 100644 --- a/README_EN.md +++ b/README_EN.md @@ -14,6 +14,7 @@ 🏛 Architecture · 📋 Features · äž­æ–‡ · + 日本語 · Contributing

diff --git a/README_JA.md b/README_JA.md new file mode 100644 index 0000000..8fb02c9 --- /dev/null +++ b/README_JA.md @@ -0,0 +1,444 @@ +

⚔ Edict · マルチ゚ヌゞェント・オヌケストレヌション

+ +

+ 䞭囜1,300幎の垝囜統治をモデルにしたAIマルチ゚ヌゞェントシステムを構築したした。
叀代の官僚制床は、珟代のAIフレヌムワヌクよりも䞉暩分立を深く理解しおいたのです。
+

+ +

+ 12のAI゚ヌゞェント11の業務ロヌル1の互換ロヌルが䞉省六郚を構成倪子が振り分け、䞭曞省が立案、門䞋省が審査、尚曞省が配分、六郚が実行。
CrewAIにはない制床的レビュヌゲヌト。AutoGenにはないリアルタむムダッシュボヌド。
+

+ +

+ 🎬 デモ · + 🚀 クむックスタヌト · + 🏛 アヌキテクチャ · + 📋 機胜 · + äž­æ–‡ · + English · + Contributing +

+ +

+ OpenClaw + Python + Agents + Dashboard + License + Zero Dependencies +

+ +

+ WeChat +

+ +--- + +## 🎬 デモ + +

+ +
+ 🎥 フルデモ䞉省六郚によるAIマルチ゚ヌゞェント協調 +

+ +
+📞 GIFプレビュヌ読み蟌みが速い +

+ Edict Demo +
+ 勅什発垃 → 倪子振り分け → 䞭曞省立案 → 門䞋省審査 → 六郚実行 → 回奏30秒 +

+
+ +> 🐳 **OpenClawをお持ちでない堎合** `docker run -p 7891:7891 cft0808/edict` を実行すれば、シミュレヌションデヌタでダッシュボヌド党機胜をお詊しいただけたす。 + +--- + +## 💡 コンセプト + +倚くのマルチ゚ヌゞェントフレヌムワヌクでは、AI゚ヌゞェントが自由に䌚話し、監査や介入が困難な䞍透明な結果を生み出したす。**Edict** は根本的に異なるアプロヌチを取りたす — 䞭囜を1,400幎間統治した行政システムを借甚しおいたす + +``` +あなた皇垝 → 倪子振り分け → 䞭曞省立案 → 門䞋省審査 → 尚曞省配分 → 六郚実行 → 回奏 + 皇侊 倪子 䞭曞省 門例省 尚曞省 六郚 回奏 +``` + +これは単なる比喩ではありたせん。AIのための**真の䞉暩分立**です + +- **倪子Crown Prince** がメッセヌゞを振り分け — 雑談は自動返信、実際の指什はタスク化 +- **䞭曞省Planning** が指什を実行可胜なサブタスクに分解 +- **門䞋省Review** が蚈画を監査 — 华䞋しお再立案を匷制可胜 +- **尚曞省Dispatch** が承認枈みタスクを専門郚眲に割り圓お +- **䞃郚** が䞊列で実行、それぞれ異なる専門性を持぀ +- **デヌタサニタむズ** がファむルパス、メタデヌタ、䞍芁デヌタをタスクタむトルから自動陀去 +- すべおが**リアルタむムダッシュボヌド**を通じお流れ、監芖・介入が可胜 + +--- + +## 🀔 なぜEdictなのか + +> **「1぀のAIがすべおを間違えるのではなく、9぀の専門゚ヌゞェントが互いの成果をチェックしたす。」** + +| | CrewAI | MetaGPT | AutoGen | **Edict** | +|---|:---:|:---:|:---:|:---:| +| **レビュヌ/拒吊暩の組み蟌み** | ❌ | ⚠ | ⚠ | **✅ 専任レビュアヌ** | +| **リアルタむムかんばん** | ❌ | ❌ | ❌ | **✅ 10パネルダッシュボヌド** | +| **タスク介入** | ❌ | ❌ | ❌ | **✅ 停止 / キャンセル / 再開** | +| **完党な監査蚌跡** | ⚠ | ⚠ | ❌ | **✅ 奏摺アヌカむブ** | +| **゚ヌゞェント健党性監芖** | ❌ | ❌ | ❌ | **✅ ハヌトビヌト怜知** | +| **LLMモデルのホットスワップ** | ❌ | ❌ | ❌ | **✅ ダッシュボヌドから切替** | +| **スキル管理** | ❌ | ❌ | ❌ | **✅ 閲芧 / 远加** | +| **ニュヌス集玄** | ❌ | ❌ | ❌ | **✅ デむリヌダむゞェスト + Webhook** | +| **セットアップの耇雑さ** | äž­ | 高 | äž­ | **䜎 · ワンクリック / Docker** | + +> **コアの差別化芁玠制床的レビュヌ + 完党な可芳枬性 + リアルタむム介入** + +
+🔍 なぜ「門䞋省Review Department」がキラヌ機胜なのかクリックで展開 + +
+ +CrewAIやAutoGenの゚ヌゞェントは**「完了、出荷」**モヌドで動䜜したす — 出力の品質を誰もチェックしたせん。QA郚門のない䌚瀟で゚ンゞニアがコヌドを盎接本番にプッシュするようなものです。 + +Edictの**門䞋省Review Department** はたさにこのために存圚したす + +- 📋 **蚈画品質の監査** — 䞭曞省の分解は完党か぀劥圓か +- 🚫 **䜎品質な出力の拒吊** — 譊告ではなく、再立案を匷制するハヌドリゞェクト +- 🔄 **必須やり盎しルヌプ** — 基準を満たすたで䜕も通過しない + +これはオプションのプラグむンではありたせん — **アヌキテクチャの䞀郚**です。すべおの指什は門䞋省を通過しなければなりたせん。䟋倖はありたせん。 + +耇雑なタスクでEdictが信頌性の高い結果を出せるのはこのためです実行に到達する前に必須の品質ゲヌトがありたす。唐の倪宗は1,300幎前にこれを理解しおいたした — **チェックされない暩力は必ず誀りを生む**のです。 + +
+ +--- + +## ✹ 機胜 + +### 🏛 十二郚゚ヌゞェントアヌキテクチャ +- **倪子**Crown Princeメッセヌゞ振り分け — 雑談は自動返信、実際の指什はタスク䜜成 +- **侉省**䞭曞省・門䞋省・尚曞省による統治 +- **䞃郚**戞郚・瀌郚・兵郚・刑郚・工郚・吏郚・朝報による実行 +- 厳栌な暩限マトリクス — 誰が誰にメッセヌゞを送れるかを匷制 +- 各゚ヌゞェント独自のワヌクスペヌス、スキル、LLMモデル +- **デヌタサニタむズ** — ファむルパス、メタデヌタ、無効なプレフィックスをタむトル/備考から自動陀去 + +### 📋 コマンドセンタヌ・ダッシュボヌド10パネル + +| パネル | 説明 | +|--------|------| +| 📋 **勅什かんばん** | 状態別タスクカヌド、フィルタヌ、怜玢、ハヌトビヌトバッゞ、停止/キャンセル/再開 | +| 🔭 **郚眲モニタヌ** | パむプラむン可芖化、分垃チャヌト、ヘルスカヌド | +| 📜 **奏摺アヌカむブ** | 5フェヌズタむムラむンの自動生成アヌカむブ | +| 📜 **勅什テンプレヌト** | 9぀のプリセットパラメヌタフォヌム、コスト芋積もり、ワンクリック発什 | +| 👥 **官員䞀芧** | トヌクンリヌダヌボヌド、掻動統蚈 | +| 📰 **朝報ブリヌフィング** | 自動キュレヌションニュヌス、賌読管理、Feishuプッシュ | +| ⚙ **モデル蚭定** | ゚ヌゞェント別LLM切替、Gateway自動再起動 | +| 🛠 **スキル蚭定** | むンストヌル枈みスキルの衚瀺、新芏远加 | +| 💬 **セッション** | チャネルラベル付きリアルタむムセッション監芖 | +| 🎬 **朝議セレモニヌ** | 統蚈付き没入型デむリヌオヌプニングアニメヌション | + +--- + +## 🖌 スクリヌンショット + +### 勅什かんばん +![Kanban](docs/screenshots/01-kanban-main.png) + +
+📞 その他のスクリヌンショット + +### ゚ヌゞェントモニタヌ +![Monitor](docs/screenshots/02-monitor.png) + +### タスク詳现 +![Detail](docs/screenshots/03-task-detail.png) + +### モデル蚭定 +![Models](docs/screenshots/04-model-config.png) + +### スキル +![Skills](docs/screenshots/05-skills-config.png) + +### 官員䞀芧 +![Officials](docs/screenshots/06-official-overview.png) + +### セッション +![Sessions](docs/screenshots/07-sessions.png) + +### 奏摺アヌカむブ +![Memorials](docs/screenshots/08-memorials.png) + +### 勅什テンプレヌト +![Templates](docs/screenshots/09-templates.png) + +### 朝報ブリヌフィング +![Briefing](docs/screenshots/10-morning-briefing.png) + +### 朝議セレモニヌ +![Ceremony](docs/screenshots/11-ceremony.png) + +
+ +--- + +## 🚀 クむックスタヌト + +### Docker + +```bash +docker run -p 7891:7891 cft0808/edict +``` +http://localhost:7891 を開く + +### フルむンストヌル + +**前提条件:** [OpenClaw](https://openclaw.ai) · Python 3.9+ · macOS/Linux + +```bash +git clone https://github.com/cft0808/edict.git +cd edict +chmod +x install.sh && ./install.sh +``` + +むンストヌラヌが自動的に以䞋を行いたす +- 党郚眲のワヌクスペヌスを䜜成`~/.openclaw/workspace-*`、倪子/吏郚/朝報を含む +- 各郚眲のSOUL.mdパヌ゜ナリティファむルを䜜成 +- ゚ヌゞェント暩限マトリクスを`openclaw.json`に登録 +- デヌタディレクトリの初期化初回同期 +- Gatewayの再起動 + +### 起動 + +```bash +# タヌミナル1デヌタ同期ルヌプ15秒間隔 +bash scripts/run_loop.sh + +# タヌミナル2ダッシュボヌドサヌバヌ +python3 dashboard/server.py + +# ブラりザを開く +open http://127.0.0.1:7891 +``` + +> 📖 詳现なりォヌクスルヌは[スタヌトガむド](docs/getting-started.md)をご芧ください。 + +--- + +## 🏛 アヌキテクチャ + +``` + ┌───────────────────────────────────┐ + │ 👑 皇垝あなた │ + │ Feishu · Telegram · Signal │ + └─────────────────┬─────────────────┘ + │ 勅什発垃 + ┌─────────────────▌─────────────────┐ + │ 👑 倪子Crown Prince │ + │ 振り分け雑談→返信 / 指什→タスク │ + └─────────────────┬─────────────────┘ + │ 勅什転送 + ┌─────────────────▌─────────────────┐ + │ 📜 䞭曞省Planning Dept │ + │ 受領 → 立案 → 分解 │ + └─────────────────┬─────────────────┘ + │ 審査提出 + ┌─────────────────▌─────────────────┐ + │ 🔍 門䞋省Review Dept │ + │ 監査 → 承認 / 华䞋 🚫 │ + └─────────────────┬─────────────────┘ + │ 承認 ✅ + ┌─────────────────▌─────────────────┐ + │ 📮 尚曞省Dispatch Dept │ + │ 割圓 → 調敎 → 収集 │ + └───┬──────┬──────┬──────┬──────┬───┘ + │ │ │ │ │ + ┌─────▌┐ ┌───▌───┐ ┌▌─────┐ ┌───▌─┐ ┌▌─────┐ + │💰 戞郚│ │📝 瀌郚│ │⚔ 兵郚│ │⚖ 刑郚│ │🔧 工郚│ + │Finance│ │ Docs │ │ Eng. │ │ Law │ │ Ops │ + └──────┘ └──────┘ └──────┘ └─────┘ └──────┘ + ┌──────┐ + │📋 吏郚│ + │ HR │ + └──────┘ +``` + +### ゚ヌゞェントの圹割 + +| 郚眲 | ゚ヌゞェントID | 圹割 | 専門分野 | +|------|---------------|------|----------| +| 👑 **倪子** | `taizi` | 振り分け、芁玄 | 雑談怜出、意図抜出 | +| 📜 **䞭曞省** | `zhongshu` | 受領、立案、分解 | 芁件定矩、アヌキテクチャ | +| 🔍 **門例省** | `menxia` | 監査、門番、拒吊暩 | 品質、リスク、基準 | +| 📮 **尚曞省** | `shangshu` | 割圓、調敎、収集 | スケゞュヌリング、远跡 | +| 💰 **戞郚** | `hubu` | デヌタ、リ゜ヌス、経理 | デヌタ凊理、レポヌト | +| 📝 **瀌郚** | `libu` | 文曞、基準、報告曞 | テクニカルラむティング、APIドキュメント | +| ⚔ **兵郚** | `bingbu` | コヌド、アルゎリズム、チェック | 開発、コヌドレビュヌ | +| ⚖ **刑郚** | `xingbu` | セキュリティ、コンプラむアンス、監査 | セキュリティスキャン | +| 🔧 **工郚** | `gongbu` | CI/CD、デプロむ、ツヌル | Docker、パむプラむン | +| 📋 **吏郚** | `libu_hr` | ゚ヌゞェント管理、研修 | 登録、暩限管理 | +| 🌅 **朝報** | `zaochao` | デむリヌブリヌフィング、ニュヌス | 定期レポヌト、芁玄 | + +### 暩限マトリクス + +| 送信元 ↓ \ 送信先 → | 倪子 | 䞭曞省 | 門例省 | 尚曞省 | 六郚 | +|:---:|:---:|:---:|:---:|:---:|:---:| +| **倪子** | — | ✅ | | | | +| **䞭曞省** | ✅ | — | ✅ | ✅ | | +| **門例省** | | ✅ | — | ✅ | | +| **尚曞省** | | ✅ | ✅ | — | ✅ 党郚 | +| **六郚** | | | | ✅ | | + +### ステヌトマシン + +``` +皇垝 → 倪子振り分け → 䞭曞省立案 → 門䞋省審査 → 割圓 → 実行䞭 → ✅ 完了 + ↑ │ │ + └── 华䞋 ──┘ ブロック ── +``` + +--- + +## 📁 プロゞェクト構成 + +``` +edict/ +├── agents/ # 12゚ヌゞェントのパヌ゜ナリティテンプレヌトSOUL.md +│ ├── taizi/ # 倪子振り分け +│ ├── zhongshu/ # 䞭曞省 +│ ├── menxia/ # 門例省 +│ ├── shangshu/ # 尚曞省 +│ ├── hubu/ libu/ bingbu/ # 戞郚 / 瀌郚 / 兵郚 +│ ├── xingbu/ gongbu/ # 刑郚 / 工郚 +│ ├── libu_hr/ # 吏郚 +│ └── zaochao/ # 朝報 +├── dashboard/ +│ ├── dashboard.html # ダッシュボヌド単䞀ファむル、䟝存関係れロ、すぐに䜿える +│ ├── dist/ # ビルド枈みReactフロント゚ンドDockerむメヌゞに含む +│ └── server.py # APIサヌバヌstdlib、䟝存関係れロ +├── scripts/ # デヌタ同期自動化スクリプト +│ ├── kanban_update.py # かんばんCLIデヌタサニタむズ付き、玄300行 +│ └── ... # fetch_morning_news、sync、screenshotsなど +├── tests/ # E2Eテスト +│ └── test_e2e_kanban.py # かんばんサニタむズテスト17アサヌション +├── data/ # ランタむムデヌタgitignore察象 +├── docs/ # ドキュメントスクリヌンショット +├── install.sh # ワンクリックむンストヌラヌ +└── LICENSE # MIT +``` + +--- + +## 🔧 技術的ハむラむト + +| | | +|---|---| +| **React 18フロント゚ンド** | TypeScript + Vite + Zustand、13コンポヌネント | +| **stdlibバック゚ンド** | `server.py``http.server`ベヌス、䟝存関係れロ | +| **゚ヌゞェント思考の可芖化** | ゚ヌゞェントの思考、ツヌル呌び出し、結果をリアルタむム衚瀺 | +| **ワンクリックむンストヌル** | ワヌクスペヌス䜜成からGateway再起動たで | +| **15秒自動同期** | カりントダりン付きラむブデヌタリフレッシュ | +| **朝議セレモニヌ** | 没入型オヌプニングアニメヌション | + +--- + +## 🗺 ロヌドマップ + +> コントリビュヌション機䌚を含む完党なロヌドマップ[ROADMAP.md](ROADMAP.md) + +### フェヌズ1 — コアアヌキテクチャ ✅ +- [x] 十二郚゚ヌゞェントアヌキテクチャ暩限管理 +- [x] 倪子振り分けレむダヌ雑談 vs タスクの自動ルヌティング +- [x] リアルタむムダッシュボヌド10パネル +- [x] タスク停止 / キャンセル / 再開 +- [x] 奏摺アヌカむブ5フェヌズタむムラむン +- [x] 勅什テンプレヌトラむブラリ9プリセット +- [x] 朝議セレモニヌアニメヌション +- [x] デむリヌニュヌスFeishu Webhookプッシュ +- [x] LLMモデルのホットスワップスキル管理 +- [x] 官員䞀芧トヌクン統蚈 +- [x] セッション監芖 +- [x] 勅什デヌタサニタむズタむトル/備考のクリヌニング、䞍正デヌタの拒吊 +- [x] 重耇タスク䞊曞き保護 +- [x] E2Eかんばんテスト17アサヌション + +### フェヌズ2 — 制床的深化 🚧 +- [ ] 埡裁可モヌドヒュヌマン・むン・ザ・ルヌプ +- [ ] 功過簿゚ヌゞェントスコアリング +- [ ] 急䜿゚ヌゞェント間メッセヌゞ可芖化 +- [ ] 翰林院ナレッゞベヌス匕甚 + +### フェヌズ3 — ゚コシステム +- [ ] Docker Composeデモむメヌゞ +- [ ] Notion / Linearアダプタヌ +- [ ] 幎次考課幎間パフォヌマンスレポヌト +- [ ] モバむルレスポンシブPWA +- [ ] ClawHubマヌケットプレむス掲茉 + +--- + +## 🀝 コントリビュヌション + +あらゆる貢献を歓迎したす[CONTRIBUTING.md](CONTRIBUTING.md)をご芧ください + +- 🎚 **UI** — テヌマ、レスポンシブ、アニメヌション +- 🀖 **新゚ヌゞェント** — 専門ロヌル +- 📊 **スキル** — 郚眲専甚パッケヌゞ +- 🔗 **むンテグレヌション** — Notion · Jira · Linear · GitHub Issues +- 🌐 **i18n** — 日本語 · 韓囜語 · スペむン語 +- 📱 **モバむル** — レスポンシブ、PWA + +--- + +## 📖 䜿甚䟋 + +`examples/`ディレクトリには実際の゚ンドツヌ゚ンドのナヌスケヌスが含たれおいたす + +| 䜿甚䟋 | コマンド | 郚眲 | +|--------|---------|------| +| [競合分析](examples/competitive-analysis.md) | 「CrewAI vs AutoGen vs LangGraphを分析せよ」 | 䞭曞省→門䞋省→戞郚+兵郚+瀌郚 | +| [コヌドレビュヌ](examples/code-review.md) | 「このFastAPIコヌドのセキュリティ問題をレビュヌせよ」 | 䞭曞省→門䞋省→兵郚+刑郚 | +| [週次レポヌト](examples/weekly-report.md) | 「今週の゚ンゞニアリングチヌムレポヌトを生成せよ」 | 䞭曞省→門䞋省→戞郚+瀌郚 | + +各ケヌスには以䞋が含たれたす完党なコマンド → 䞭曞省の提案 → 門䞋省のフィヌドバック → 六郚の出力 → 最終レポヌト。 + +--- + +## 📄 ラむセンス + +[MIT](LICENSE) · [OpenClaw](https://openclaw.ai) コミュニティによっお構築 + +--- + +## 📮 WeChat · 舞台裏 + +> *叀代䞭囜では、「邞報」が垝囜党土に勅什を届けたした。今日、私たちにはWeChatアカりントがありたす。* + +

+ WeChat QR · cft0808 +
+ スキャンしおフォロヌ · cft0808 +

+ +ここで芋぀かるもの +- 🏛 アヌキテクチャの深掘り — 12゚ヌゞェントがどのように䞉暩分立を実珟するか +- 🔥 実戊蚘 — ゚ヌゞェントが争い、トヌクンを消費し、ストラむキを起こした時の話 +- 💡 トヌクン節玄のコツ — フルパむプラむンを1/10のコストで運甚 +- 🎭 SOUL.mdの裏偎 — AI゚ヌゞェントにキャラクタヌを維持させるプロンプトの曞き方 + +--- + +## ⭐ スタヌ履歎 + +[![Star History Chart](https://api.star-history.com/svg?repos=cft0808/edict&type=Date)](https://star-history.com/#cft0808/edict&Date) + +--- + +

+ ⚔ 叀代垝囜の知恵でAIを統治する
+ 以叀制埡新技以智慧驟驭 AI

+ WeChat +