modkh 0.0.0-stage → 0.2.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +66 -2
- package/dist/agent/bundled-skills.d.ts +13 -0
- package/dist/agent/bundled-skills.js +95 -0
- package/dist/agent/compaction.d.ts +53 -0
- package/dist/agent/compaction.js +191 -0
- package/dist/agent/images.d.ts +10 -0
- package/dist/agent/images.js +33 -0
- package/dist/agent/loop.d.ts +103 -0
- package/dist/agent/loop.js +267 -0
- package/dist/agent/skills.d.ts +26 -0
- package/dist/agent/skills.js +190 -0
- package/dist/agent/types.d.ts +137 -0
- package/dist/agent/types.js +12 -0
- package/dist/cli/agenticreplay.d.ts +1 -0
- package/dist/cli/agenticreplay.js +66 -0
- package/dist/cli/agents.d.ts +8 -0
- package/dist/cli/agents.js +12 -0
- package/dist/cli/answer-markdown.d.ts +3 -0
- package/dist/cli/answer-markdown.js +29 -0
- package/dist/cli/approval.d.ts +29 -0
- package/dist/cli/approval.js +92 -0
- package/dist/cli/catalog.d.ts +37 -0
- package/dist/cli/catalog.js +46 -0
- package/dist/cli/chat.d.ts +18 -0
- package/dist/cli/chat.js +1061 -0
- package/dist/cli/clipboard.d.ts +11 -0
- package/dist/cli/clipboard.js +82 -0
- package/dist/cli/color.d.ts +59 -0
- package/dist/cli/color.js +244 -0
- package/dist/cli/compaction-settings.d.ts +21 -0
- package/dist/cli/compaction-settings.js +54 -0
- package/dist/cli/completion-art.d.ts +2 -0
- package/dist/cli/completion-art.js +62 -0
- package/dist/cli/config.d.ts +50 -0
- package/dist/cli/config.js +192 -0
- package/dist/cli/editor.d.ts +23 -0
- package/dist/cli/editor.js +115 -0
- package/dist/cli/file-mentions.d.ts +14 -0
- package/dist/cli/file-mentions.js +141 -0
- package/dist/cli/head-checks.d.ts +41 -0
- package/dist/cli/head-checks.js +146 -0
- package/dist/cli/initial-connection.d.ts +7 -0
- package/dist/cli/initial-connection.js +20 -0
- package/dist/cli/keys.d.ts +29 -0
- package/dist/cli/keys.js +107 -0
- package/dist/cli/language.d.ts +1 -0
- package/dist/cli/language.js +105 -0
- package/dist/cli/limits.d.ts +13 -0
- package/dist/cli/limits.js +19 -0
- package/dist/cli/lines.d.ts +18 -0
- package/dist/cli/lines.js +80 -0
- package/dist/cli/model-catalog.d.ts +16 -0
- package/dist/cli/model-catalog.js +130 -0
- package/dist/cli/models.d.ts +4 -0
- package/dist/cli/models.js +101 -0
- package/dist/cli/official-models.d.ts +6 -0
- package/dist/cli/official-models.js +77 -0
- package/dist/cli/pdf.d.ts +8 -0
- package/dist/cli/pdf.js +71 -0
- package/dist/cli/permissions.d.ts +25 -0
- package/dist/cli/permissions.js +30 -0
- package/dist/cli/plugins.d.ts +1 -0
- package/dist/cli/plugins.js +53 -0
- package/dist/cli/providers.d.ts +10 -0
- package/dist/cli/providers.js +82 -0
- package/dist/cli/shell-display.d.ts +6 -0
- package/dist/cli/shell-display.js +35 -0
- package/dist/cli/stateright.d.ts +1 -0
- package/dist/cli/stateright.js +37 -0
- package/dist/cli/terminal-mouse.d.ts +21 -0
- package/dist/cli/terminal-mouse.js +51 -0
- package/dist/cli/terminal.d.ts +231 -0
- package/dist/cli/terminal.js +1417 -0
- package/dist/cli/tool-display.d.ts +9 -0
- package/dist/cli/tool-display.js +87 -0
- package/dist/cli/transcript-selection.d.ts +22 -0
- package/dist/cli/transcript-selection.js +75 -0
- package/dist/cli/usage.d.ts +22 -0
- package/dist/cli/usage.js +117 -0
- package/dist/cli/waiting-nyan.d.ts +3 -0
- package/dist/cli/waiting-nyan.js +17 -0
- package/dist/cli/waiting-whales.d.ts +3 -0
- package/dist/cli/waiting-whales.js +24 -0
- package/dist/index.d.ts +11 -0
- package/dist/index.js +186 -0
- package/dist/language/catalog.d.ts +44 -0
- package/dist/language/catalog.js +100 -0
- package/dist/language/commonlisp-bundled.d.ts +11 -0
- package/dist/language/commonlisp-bundled.js +22 -0
- package/dist/language/commonlisp-dependencies.d.ts +16 -0
- package/dist/language/commonlisp-dependencies.js +68 -0
- package/dist/language/commonlisp-install.d.ts +15 -0
- package/dist/language/commonlisp-install.js +214 -0
- package/dist/language/commonlisp-reader.d.ts +17 -0
- package/dist/language/commonlisp-reader.js +47 -0
- package/dist/language/commonlisp-systems.d.ts +3 -0
- package/dist/language/commonlisp-systems.js +32 -0
- package/dist/language/commonlisp-tls.d.ts +10 -0
- package/dist/language/commonlisp-tls.js +51 -0
- package/dist/language/detect.d.ts +29 -0
- package/dist/language/detect.js +103 -0
- package/dist/language/grammars/LICENSE +24 -0
- package/dist/language/grammars/manifest.json +76 -0
- package/dist/language/grammars/tree-sitter-c.wasm +0 -0
- package/dist/language/grammars/tree-sitter-cpp.wasm +0 -0
- package/dist/language/grammars/tree-sitter-css.wasm +0 -0
- package/dist/language/grammars/tree-sitter-html.wasm +0 -0
- package/dist/language/grammars/tree-sitter-javascript.wasm +0 -0
- package/dist/language/grammars/tree-sitter-php.wasm +0 -0
- package/dist/language/grammars/tree-sitter-python.wasm +0 -0
- package/dist/language/grammars/tree-sitter-ruby.wasm +0 -0
- package/dist/language/grammars/tree-sitter-rust.wasm +0 -0
- package/dist/language/grammars/tree-sitter-swift.wasm +0 -0
- package/dist/language/grammars/tree-sitter-tsx.wasm +0 -0
- package/dist/language/grammars/tree-sitter-typescript.wasm +0 -0
- package/dist/language/install.d.ts +50 -0
- package/dist/language/install.js +293 -0
- package/dist/language/lsp/client.d.ts +97 -0
- package/dist/language/lsp/client.js +340 -0
- package/dist/language/lsp/pool.d.ts +75 -0
- package/dist/language/lsp/pool.js +140 -0
- package/dist/language/lsp/service.d.ts +50 -0
- package/dist/language/lsp/service.js +174 -0
- package/dist/language/native.d.ts +8 -0
- package/dist/language/native.js +100 -0
- package/dist/language/platform.d.ts +14 -0
- package/dist/language/platform.js +20 -0
- package/dist/language/positions.d.ts +20 -0
- package/dist/language/positions.js +46 -0
- package/dist/language/syntax/assets.d.ts +9 -0
- package/dist/language/syntax/assets.js +73 -0
- package/dist/language/syntax/parser.d.ts +33 -0
- package/dist/language/syntax/parser.js +162 -0
- package/dist/language/typescript-capability.d.ts +6 -0
- package/dist/language/typescript-capability.js +42 -0
- package/dist/lisp/builtin-agents.d.ts +5 -0
- package/dist/lisp/builtin-agents.js +52 -0
- package/dist/lisp/config.d.ts +25 -0
- package/dist/lisp/config.js +202 -0
- package/dist/lisp/routing.d.ts +5 -0
- package/dist/lisp/routing.js +24 -0
- package/dist/lisp/runtime.d.ts +26 -0
- package/dist/lisp/runtime.js +107 -0
- package/dist/memory/kiokuko.d.ts +32 -0
- package/dist/memory/kiokuko.js +102 -0
- package/dist/memory/mcp.d.ts +38 -0
- package/dist/memory/mcp.js +211 -0
- package/dist/model/ai-sdk.d.ts +27 -0
- package/dist/model/ai-sdk.js +185 -0
- package/dist/model/chatgpt/login.d.ts +42 -0
- package/dist/model/chatgpt/login.js +180 -0
- package/dist/model/chatgpt/responses.d.ts +41 -0
- package/dist/model/chatgpt/responses.js +254 -0
- package/dist/model/chatgpt/tokens.d.ts +11 -0
- package/dist/model/chatgpt/tokens.js +50 -0
- package/dist/model/connection.d.ts +6 -0
- package/dist/model/connection.js +67 -0
- package/dist/model/context-window.d.ts +3 -0
- package/dist/model/context-window.js +64 -0
- package/dist/model/context.d.ts +11 -0
- package/dist/model/context.js +69 -0
- package/dist/model/factory.d.ts +27 -0
- package/dist/model/factory.js +89 -0
- package/dist/model/fixed.d.ts +17 -0
- package/dist/model/fixed.js +41 -0
- package/dist/model/harness-profile.d.ts +6 -0
- package/dist/model/harness-profile.js +23 -0
- package/dist/model/providers.d.ts +32 -0
- package/dist/model/providers.js +72 -0
- package/dist/model/reasoning.d.ts +16 -0
- package/dist/model/reasoning.js +84 -0
- package/dist/model/record-fetch.d.ts +2 -0
- package/dist/model/record-fetch.js +19 -0
- package/dist/plugins/api.d.ts +60 -0
- package/dist/plugins/api.js +1 -0
- package/dist/plugins/manager.d.ts +35 -0
- package/dist/plugins/manager.js +280 -0
- package/dist/plugins/package.d.ts +13 -0
- package/dist/plugins/package.js +99 -0
- package/dist/plugins/registry.d.ts +8 -0
- package/dist/plugins/registry.js +14 -0
- package/dist/session/store.d.ts +93 -0
- package/dist/session/store.js +311 -0
- package/dist/session/workspace.d.ts +19 -0
- package/dist/session/workspace.js +73 -0
- package/dist/subagents/head-assignment.d.ts +11 -0
- package/dist/subagents/head-assignment.js +47 -0
- package/dist/subagents/limits.d.ts +4 -0
- package/dist/subagents/limits.js +6 -0
- package/dist/subagents/processes.d.ts +18 -0
- package/dist/subagents/processes.js +73 -0
- package/dist/subagents/request.d.ts +4 -0
- package/dist/subagents/request.js +38 -0
- package/dist/subagents/service.d.ts +73 -0
- package/dist/subagents/service.js +645 -0
- package/dist/subagents/settings.d.ts +10 -0
- package/dist/subagents/settings.js +32 -0
- package/dist/subagents/types.d.ts +63 -0
- package/dist/subagents/types.js +1 -0
- package/dist/subagents/verification.d.ts +34 -0
- package/dist/subagents/verification.js +215 -0
- package/dist/tools/browse.d.ts +13 -0
- package/dist/tools/browse.js +117 -0
- package/dist/tools/browser-capability.d.ts +3 -0
- package/dist/tools/browser-capability.js +29 -0
- package/dist/tools/diff.d.ts +6 -0
- package/dist/tools/diff.js +82 -0
- package/dist/tools/edit.d.ts +3 -0
- package/dist/tools/edit.js +152 -0
- package/dist/tools/files.d.ts +6 -0
- package/dist/tools/files.js +96 -0
- package/dist/tools/formal-input.d.ts +6 -0
- package/dist/tools/formal-input.js +29 -0
- package/dist/tools/formal.d.ts +9 -0
- package/dist/tools/formal.js +79 -0
- package/dist/tools/guard.d.ts +7 -0
- package/dist/tools/guard.js +48 -0
- package/dist/tools/job-tools.d.ts +19 -0
- package/dist/tools/job-tools.js +148 -0
- package/dist/tools/jobs.d.ts +79 -0
- package/dist/tools/jobs.js +186 -0
- package/dist/tools/language.d.ts +6 -0
- package/dist/tools/language.js +172 -0
- package/dist/tools/lean-proof.d.ts +38 -0
- package/dist/tools/lean-proof.js +83 -0
- package/dist/tools/registry.d.ts +30 -0
- package/dist/tools/registry.js +113 -0
- package/dist/tools/run.d.ts +13 -0
- package/dist/tools/run.js +163 -0
- package/dist/tools/search.d.ts +2 -0
- package/dist/tools/search.js +156 -0
- package/dist/tools/shell-process.d.ts +115 -0
- package/dist/tools/shell-process.js +297 -0
- package/dist/tools/skills.d.ts +2 -0
- package/dist/tools/skills.js +46 -0
- package/dist/tools/stateright-runtime.d.ts +3 -0
- package/dist/tools/stateright-runtime.js +16 -0
- package/dist/tools/stateright.d.ts +3 -0
- package/dist/tools/stateright.js +78 -0
- package/dist/tools/web.d.ts +24 -0
- package/dist/tools/web.js +391 -0
- package/dist/version.d.ts +2 -0
- package/dist/version.js +2 -0
- package/docs/ci-repair-20261116.md +30 -0
- package/docs/commonlisp-build-output.md +14 -0
- package/docs/commonlisp-provider-migration.md +22 -0
- package/docs/commonlisp-qlot-recovery.md +28 -0
- package/docs/commonlisp-tls-recovery.md +28 -0
- package/docs/context-efficiency.md +122 -0
- package/docs/input.md +126 -0
- package/docs/languages.md +117 -0
- package/docs/models.md +109 -0
- package/docs/modkh-evidence.json +641 -0
- package/docs/modkh-failure-comparison.json +675 -0
- package/docs/modkh-namespace.md +39 -0
- package/docs/modkh-qlot-evidence.json +37 -0
- package/docs/modkh-verification.md +173 -0
- package/docs/modkh.md +128 -0
- package/docs/presets.md +64 -0
- package/docs/setup.md +99 -0
- package/docs/stateright.md +45 -0
- package/docs/subagents.md +152 -0
- package/docs/web.md +57 -0
- package/experiments/presets/common-lisp.lisp +38 -0
- package/experiments/presets/css.lisp +38 -0
- package/experiments/presets/formal.lisp +18 -0
- package/experiments/presets/html.lisp +38 -0
- package/experiments/presets/js.lisp +38 -0
- package/experiments/presets/language-microagents.lisp +29 -0
- package/experiments/presets/php.lisp +38 -0
- package/experiments/presets/svelte.lisp +38 -0
- package/experiments/presets/tailwindcss.lisp +24 -0
- package/experiments/presets/ts.lisp +38 -0
- package/native/stateright/Cargo.lock +478 -0
- package/native/stateright/Cargo.toml +11 -0
- package/native/stateright/src/lib.rs +163 -0
- package/native/stateright/src/main.rs +38 -0
- package/package.json +57 -4
- package/plugins/modkh-explorer/index.mjs +3 -0
- package/plugins/modkh-explorer/plugin.json +1 -0
- package/plugins/modkh-worker/index.mjs +3 -0
- package/plugins/modkh-worker/plugin.json +1 -0
- package/skills/kiokuko-dsh/LICENSE +21 -0
- package/skills/kiokuko-dsh/coding-ideal-routine-skill/SKILL.md +106 -0
- package/skills/kiokuko-dsh/japanese-translation-for-oss-models/SKILL.md +65 -0
- package/skills/kiokuko-dsh/kiokuko-architecture/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-architecture/references/cases.md +11 -0
- package/skills/kiokuko-dsh/kiokuko-benchmark/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-benchmark/references/cases.md +11 -0
- package/skills/kiokuko-dsh/kiokuko-investigate/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-investigate/references/cases.md +11 -0
- package/skills/kiokuko-dsh/kiokuko-lisp/SKILL.md +390 -0
- package/skills/kiokuko-dsh/kiokuko-review/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-review/references/cases.md +11 -0
- package/skills/kiokuko-dsh/kiokuko-simple-work/SKILL.md +70 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/SKILL.md +79 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/boundaries-and-ownership.md +52 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/domain-and-types.md +48 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/effects-and-data.md +43 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/kiokuko-patterns.md +314 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/problem-shaping-and-language.md +90 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/protocols-and-idempotency.md +42 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/review-checklist.md +92 -0
- package/skills/kiokuko-dsh/kiokuko-single-purpose-functions/references/verification.md +45 -0
- package/skills/kiokuko-dsh/kiokuko-skill-authoring/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-skill-authoring/references/cases.md +11 -0
- package/skills/kiokuko-dsh/kiokuko-soul/SKILL.md +25 -0
- package/skills/kiokuko-dsh/kiokuko-technical-writing/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-technical-writing/references/cases.md +11 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/SKILL.md +64 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/accessibility-and-navigation.md +31 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/async-recovery.md +49 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/forms-and-controls.md +35 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/interaction-feedback.md +34 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/responsive-and-platform.md +38 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/safety-and-review.md +43 -0
- package/skills/kiokuko-dsh/kiokuko-ui-design-soul/references/ui-checklist.md +75 -0
- package/skills/kiokuko-dsh/kiokuko-verification/SKILL.md +20 -0
- package/skills/kiokuko-dsh/kiokuko-verification/references/cases.md +11 -0
- package/skills/kiokuko-dsh/manifest.json +168 -0
- package/skills/kiokuko-dsh/memory-reasoning/SKILL.md +44 -0
- package/skills/kiokuko-dsh/one-shot-software-completion/SKILL.md +113 -0
- package/skills/kiokuko-dsh/one-shot-software-completion/references/boundaries-and-lifecycle.md +70 -0
- package/skills/kiokuko-dsh/one-shot-software-completion/references/discovery-and-scope.md +71 -0
- package/skills/kiokuko-dsh/one-shot-software-completion/references/failure-recovery.md +43 -0
- package/skills/kiokuko-dsh/one-shot-software-completion/references/verification-and-completion.md +73 -0
- package/skills/kiokuko-dsh/veteran-programmer-skill/SKILL.md +66 -0
|
@@ -0,0 +1,122 @@
|
|
|
1
|
+
# 目的別スキルとモデル入力の節約
|
|
2
|
+
|
|
3
|
+
通常のMODKHチャットとローカル子エージェントで自動的に有効です。追加のモデル呼び出し・パッケージ・Kiokuko接続は不要です。外部エージェントの内部プロンプトは対象外です。
|
|
4
|
+
|
|
5
|
+
## 目的別スキル
|
|
6
|
+
|
|
7
|
+
kiokuko-dshのスキル17件と参照資料を含む43ファイルを、原文のまま `skills/kiokuko-dsh/` に同梱しています。独自の短い `modkh-*` 代用品は廃止しました。
|
|
8
|
+
|
|
9
|
+
| 選択条件 | 注入するスキル |
|
|
10
|
+
| --- | --- |
|
|
11
|
+
| スキル適用時の入口 | `kiokuko-soul` |
|
|
12
|
+
| コードの実装・修正 | `coding-ideal-routine-skill`、`one-shot-software-completion`、`kiokuko-single-purpose-functions` |
|
|
13
|
+
| 調査・設計・レビュー | `kiokuko-investigate`、`kiokuko-architecture`、`kiokuko-review` |
|
|
14
|
+
| 性能・検証 | `kiokuko-benchmark`、`kiokuko-verification` |
|
|
15
|
+
| 小さな変更・導入や状態の変更 | `kiokuko-simple-work`、`veteran-programmer-skill` |
|
|
16
|
+
| UI | `kiokuko-ui-design-soul` |
|
|
17
|
+
| スキル・技術文書の作成 | `kiokuko-skill-authoring`、`kiokuko-technical-writing` |
|
|
18
|
+
| 記憶・Lisp | `memory-reasoning`、`kiokuko-lisp` |
|
|
19
|
+
| 日本語の依頼、またはJapanese指定 | `natural-japanese-output` |
|
|
20
|
+
|
|
21
|
+
日本語・英語のキーワード一致で選び、`$kiokuko-review` のような明示指定を優先します。意味を理解する分類器ではなく、否定や引用も意味解析しません。任意の専門スキルは最大3件で、SOUL・コーディングの共通手順・日本語出力は別枠です。合計の注入上限は48 KiBです。旧12 KiB制限では実際の共通手順さえ収まらないため変更しています。利用者の実際の依頼・既存の上位指示・ツール承認が常に優先されます。
|
|
22
|
+
|
|
23
|
+
スキル内で著者が `kiokuko:runtime` と指定した部分は全て保持し、`documentation` 部分だけを初期注入から除きます。未分類のスキルはfrontmatterを除いて全文を保持します。独自の要約で規則を削りません。
|
|
24
|
+
|
|
25
|
+
モデルは `list_skills` で17件の名前・説明・参照パスを確認し、`read_skill` で必要な本文・詳細資料を読みます。`resource` は一覧にある相対パスだけを受け付けます。長い本文には `nextLine` が返り、`startLine` に指定して続きを取得できます。組み込みworker/explorerにも両ツールを公開しています。独自の子プラグインは必要に応じて許可ツール一覧へ追加してください。
|
|
26
|
+
|
|
27
|
+
DSH固有の `kioku_*`、`lisp_*`、Akinator、Goal、lease、`coding_workflow`、`task_completion` はMODKHにはありません。注入時・参照読み取り時にMODKHの適用規則を付け、存在しないAPIの呼び出し・導入・完了待ちを禁止し、実際のMODKHツールと承認に従わせます。Lispワーカーや自動記憶保存そのものを移植したという意味ではありません。
|
|
28
|
+
|
|
29
|
+
本文を途中で切ると制約が落ちるため、予算に入らない本文は丸ごと省略して通知します。一度の選択で本文が完全一致する場合は重複を除きます。通常のCLI会話では、選んだ手順をsystem入力に一度だけ載せ、同じ起動中は本文を固定します。次の依頼で新たに選んだ手順は上限内で追加します。本文はセッション履歴に保存せず、再起動後は選び直します。表示のbytesは注入テキストのUTF-8サイズであり、トークン数ではありません。
|
|
30
|
+
|
|
31
|
+
### プロジェクト固有のスキル
|
|
32
|
+
|
|
33
|
+
作業ルートの `.modkh/skills.json` に、既存の手順ファイルを登録できます。
|
|
34
|
+
|
|
35
|
+
```json
|
|
36
|
+
[
|
|
37
|
+
{
|
|
38
|
+
"name": "php-project",
|
|
39
|
+
"description": "このプロジェクトのPHP実装手順",
|
|
40
|
+
"keywords": ["PHP", "Laravel", "Eloquent"],
|
|
41
|
+
"path": "docs/php-workflow.md"
|
|
42
|
+
}
|
|
43
|
+
]
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
`PHPの処理を調査` などのキーワード一致、または `$php-project` の明示指定で本文を読みます。`description` は説明用で、選択には `keywords` を使用します。全本文の事前注入や自動ダウンロードは行いません。既存の `SKILL.md` もpathで指定できますが、本文全体をそのまま扱うため、実行手順だけの短いファイルを推奨します。
|
|
47
|
+
|
|
48
|
+
- 名前は英小文字で始まる英小文字・数字・ハイフン、最大64文字。重複・組み込み名の上書きは不可。
|
|
49
|
+
- 一覧は64 KiB・128件まで。keywordsは32件まで、各1〜80文字。descriptionは500文字まで。
|
|
50
|
+
- pathは作業ルート内の相対パス。範囲外へ解決されるシンボリックリンク、通常ファイルでないもの、12 KiBを超える本文は注入しません。
|
|
51
|
+
- 不正な一覧・読めない本文は通知して通常の作業を続けます。未選択の本文は読みません。
|
|
52
|
+
- `.modkh/` をgitignoreしている場合、一覧を共有するには明示的に管理対象にしてください。
|
|
53
|
+
- 埋め込み利用では `runAgentLoop` の `skills: false` で注入を無効化できます。
|
|
54
|
+
|
|
55
|
+
## ツール出力
|
|
56
|
+
|
|
57
|
+
AI SDK経由とChatGPT Responses経由の両方で、モデルに渡す投影だけを変更します。保存済みの原文・call ID・status・承認・再実行防止は変更しません。
|
|
58
|
+
|
|
59
|
+
1. 連続して同じ行が現れる出力は、文字列と回数のJSONへ可逆変換します。改行・順序・末尾文字列を保持し、説明を含めてもUTF-8サイズが小さくなるときだけ採用します。対象は1,024〜2,000,000 UTF-16コード単位です。
|
|
60
|
+
2. それでも1件16 KiBの枠を超える場合、原文の先頭と末尾を残し、中間省略を明示します。圧縮JSONを途中で切ることはしません。
|
|
61
|
+
3. 128 KiBの枠は保存されたツールメッセージごとに割り当てます。後続の結果を追加しても、すでに送信した結果の本文は変わりません。会話全体のサイズは履歴とともに増えます。
|
|
62
|
+
|
|
63
|
+
実プロバイダーのトークン数・キャッシュ・請求額の削減率は未測定です。文字数の削減率と料金の削減率は異なります。
|
|
64
|
+
|
|
65
|
+
`cache` の表示はプロバイダーが報告した値だけを使います。DeepSeek は `prompt_cache_hit_tokens` を報告するため、キャッシュ読取りは入力に含めた値として表示されます。
|
|
66
|
+
|
|
67
|
+
## プロバイダーのキャッシュを保つ入力の並び
|
|
68
|
+
|
|
69
|
+
DeepSeek などのプロバイダーは、直前のリクエストと先頭から一致する部分をキャッシュとして再利用します。一致は先頭から途切れるまでなので、変わらない内容を前に、ターンごとに変わる内容を後ろに置きます。
|
|
70
|
+
|
|
71
|
+
- system指示(基本方針と選択済みスキル)は起動中に固定し、毎回同じバイト列を送ります。
|
|
72
|
+
- 記憶の検索結果は、そのターンだけの参考データです。system の末尾に足すと、その位置から後ろの履歴全体がキャッシュミスになるため、最新の入力として末尾へ付け、セッション履歴には保存しません。
|
|
73
|
+
- ツール結果の投影は送信済みの本文を書き換えないため、履歴が伸びても既存部分の一致は保たれます。
|
|
74
|
+
|
|
75
|
+
計測例(DeepSeek のリクエスト本文を模した4ターン・各ターン5ステップ、ツール出力を含む約125万文字の送信)では、記憶を system に置くとキャッシュミス相当が23.1%、最新入力に置くと9.6%でした。文字数の比較であり、実プロバイダーの請求額やトークン数の削減率ではありません。
|
|
76
|
+
|
|
77
|
+
## 会話履歴の自動圧縮
|
|
78
|
+
|
|
79
|
+
通常のCLI会話では、直前の会話リクエストでプロバイダーが報告した入力トークン数が、選択中のモデルのコンテキスト長の75%に達すると、次の送信前に古い履歴を要約します。キャッシュ済みの入力も含みます。ツール呼び出し後も同じ条件で判定します。セッション累計、子エージェント、要約リクエストの使用量は加算しません。初回・再開直後・接続変更直後は最初の実測値を待ちます。次に追加する入力のトークン数は送信前には分からないため、大きな追加入力が上限を超えることはあります。
|
|
80
|
+
|
|
81
|
+
ChatGPTではローカルのCodexモデルカタログ、Google・Anthropicではモデル情報API、ローカルOllamaとLM Studioでは稼働中モデルの情報、OpenRouterなどの互換接続では接続先のモデル一覧から容量を取得します。容量を公開していない接続先では、`config.json` に `"modelContextWindows": {"compatible/my-model": 65536}` のようにトークン単位で指定できます。容量または入力トークン数が不明な間は自動圧縮を見送ります。
|
|
82
|
+
|
|
83
|
+
直近の履歴は `compactionKeepTurns`(既定6、1〜50)ターン残します。要約できる本文が送信本文の1/8に満たない場合は見送ります。要約に失敗した場合や短くならなかった場合は、要約対象がさらにその分増えるまで再試行を控えます。従来のバイト基準を明示的に使う場合は `compactionAutoBytes`(32 KiB〜8 MiBをバイト単位で指定)を設定します。この場合の1/8は設定したバイト数が基準です。0で自動圧縮を無効にできます。
|
|
84
|
+
|
|
85
|
+
元のメッセージとツール結果はセッションに残り、`--resume` 後も最後に保存した要約と直近の履歴をモデルへ渡します。固定応答モデル、Hermes Agent、子エージェントでは新たな自動圧縮を行いません。
|
|
86
|
+
|
|
87
|
+
## 参考実装と検証
|
|
88
|
+
|
|
89
|
+
[kiokuko-dsh](https://github.com/askdkc/kiokuko-dsh) のローカル参照コミット `795172935041acb29718860458a59501a98fd466` にある、目的別選択、実行手順と文書の分離、重複注入回避、可逆な反復文字列圧縮を参考にMODKHのループへ独立実装しました。KiokukoのDB・タスク状態・モデルによるスキル選択・意味的要約は移植していません。スキルセットは後続の修正で `88dac41e9f92d4638a214825b40e6967499be961` から同梱しました。`manifest.json` に全43ファイルのSHA-256を記録し、読み込み時とビルド時に検証します。MITライセンスも同梱しています。
|
|
90
|
+
|
|
91
|
+
```sh
|
|
92
|
+
node --test test/bundled.skills.test.ts test/skills.context.test.ts test/context.efficiency.test.ts
|
|
93
|
+
npm run typecheck
|
|
94
|
+
npm run build
|
|
95
|
+
node scripts/verify-skill-package.mjs
|
|
96
|
+
npm test
|
|
97
|
+
```
|
|
98
|
+
|
|
99
|
+
2026-11-15の検証では、旧ループを隔離コピーに戻すとスキル注入テストが失敗することを確認しています。全体テストにはローカルHTTPサーバーとファイル監視を使うケースがあるため、それらを許可した環境での実行が必要です。
|
|
100
|
+
|
|
101
|
+
### 初回の確認結果(スキルセット同梱前)
|
|
102
|
+
|
|
103
|
+
対象はMODKH `7a93e8c731e4fcec190ee09986bedf1756412f11` を基点とする今回の変更です。
|
|
104
|
+
|
|
105
|
+
- `npm run typecheck`、`npm run build`、`git diff --check`: 成功。
|
|
106
|
+
- `node --test test/bundled.skills.test.ts test/skills.context.test.ts test/context.efficiency.test.ts test/agent.loop.test.ts test/subagents.service.test.ts`: 36件成功。
|
|
107
|
+
- `npm test`: 366件中308件成功、58件失敗。57件はローカルHTTP待受の `EPERM`、1件は `fs.watch` の `EMFILE`。追加のAI SDK送信形式テストは、その後の関連36件に含めて成功。HTTP結合テストは未検証。
|
|
108
|
+
- ビルド済み `dist/index.js` を一時的な作業ルート・専用の `MODKH_HOME`・`fixed/scripted` で実行し、`modkh-debug` 選択表示、README編集、コマンドのマーカー作成、終了コード0を確認。実プロバイダーによる課題解決能力の検証ではない。
|
|
109
|
+
- 隔離コピーで旧ループに戻すと注入テストが失敗。圧縮を無効にする変更、末尾を捨てる変更も、それぞれ回帰テストが検出。
|
|
110
|
+
- 合成反復ログは90,010 bytes → 176 bytes。これはこの入力のUTF-8サイズ比較に限定され、トークン・料金の測定ではない。
|
|
111
|
+
|
|
112
|
+
グローバルにインストール済みのMODKHの更新・動作確認、実プロバイダーへの通信は行っていません。
|
|
113
|
+
|
|
114
|
+
### スキルセット同梱後の確認結果
|
|
115
|
+
|
|
116
|
+
- 17スキル・26参照資料(計43ファイル)が移植元とバイト単位で一致。全ファイルのSHA-256検証とruntimeブロック抽出が成功。
|
|
117
|
+
- `npm run typecheck`、`npm run build`、`git diff --check`: 成功。
|
|
118
|
+
- `node --test test/bundled.skills.test.ts test/skills.context.test.ts test/context.efficiency.test.ts test/agent.loop.test.ts test/subagents.service.test.ts test/tools.guard.test.ts`: 53件成功。
|
|
119
|
+
- `npm test`: 373件中315件成功、58件失敗。ローカルHTTP待受の `EPERM` 57件、ファイル監視の `EMFILE` 1件。これらの結合検証は未完了。
|
|
120
|
+
- `node scripts/verify-skill-package.mjs`: npm packした配布物を一時ディレクトリへ展開し、別の作業ルートで実際の共通ループからコーディング手順・UI手順を注入、`read_skill` で参照資料を取得できた。隔離した配布物の本文を改変するとハッシュ検証が拒否することも確認。
|
|
121
|
+
- 先に追加したコーディング受け入れテストは、同梱・接続前には `missing kiokuko-soul` で失敗し、導入後に成功。
|
|
122
|
+
- 注入量の例: 英語のバグ修正29,772 bytes、日本語のUI修正38,379 bytes、Lispコード実装45,929 bytes。全17件の一括注入ではなく、必要な共通手順と専門手順を選択した結果。実トークン数・料金・実モデルが手順へ従う品質は未測定。
|
package/docs/input.md
ADDED
|
@@ -0,0 +1,126 @@
|
|
|
1
|
+
# 入力欄・画像の貼り付け
|
|
2
|
+
|
|
3
|
+
## 複数行の入力
|
|
4
|
+
|
|
5
|
+
通常の対話入力欄は基本3行です(高さの足りない端末では画面内に収めます)。改行や折り返しに応じて広がります。起動画面では上下へ、会話中は履歴領域を確保しながら上へ広がります。画面の高さを超えた分は入力欄内でスクロールし、カーソル位置を表示します。
|
|
6
|
+
|
|
7
|
+
| 操作 | キー |
|
|
8
|
+
| --- | --- |
|
|
9
|
+
| 送信 | Enter |
|
|
10
|
+
| 改行 | Ctrl+J。端末が対応していればShift+Enter / Option+Enterも使用可能 |
|
|
11
|
+
| 行を移動 | ↑ / ↓ |
|
|
12
|
+
| 行頭・行末 | Home / End、Ctrl+A / Ctrl+E |
|
|
13
|
+
| 入力を消去 | Ctrl+U |
|
|
14
|
+
| Macでテキストを貼り付け | Cmd+V(端末の「ペースト」) |
|
|
15
|
+
| Macで画像を添付 | Ctrl+V |
|
|
16
|
+
| 最後の添付画像を削除・画像読込を中止 | Ctrl+X |
|
|
17
|
+
|
|
18
|
+
Cmd+VはmacOSの端末側が処理するショートカットです。MODKHではテキスト貼り付けを横取りしません。bracketed pasteに対応した端末では、貼り付けた改行を保ち、末尾に改行があっても自動送信しません。複数行の `/exit` などは会話本文として扱い、コマンドを実行しません。
|
|
19
|
+
|
|
20
|
+
操作の承認を求められたら、↑↓で「拒否」か「承認」を選び、Enterで確定します。初期選択は「拒否」です。表示から3分経つと自動で拒否します。行入力モードでは `y` と Enter で承認します。
|
|
21
|
+
|
|
22
|
+
プロバイダー検索と認証キーは1行で入力します。`MODKH_PLAIN=1` や非TTYの行入力モードでは、複数行エディター・クリップボード画像は使わず、従来の1行ずつの入力を維持します。
|
|
23
|
+
|
|
24
|
+
## `@` でローカルファイルを添付する
|
|
25
|
+
|
|
26
|
+
会話入力欄の先頭か空白の直後で `@` を入力すると、作業ルートのファイル・フォルダー候補が表示されます。`@src/` のようにパスを入力して絞り込み、**↑↓** で選び、**Tab** で補完します。フォルダーを補完すると、その中の候補が表示されます。**Esc** で候補を閉じられます。
|
|
27
|
+
|
|
28
|
+
```text
|
|
29
|
+
@src/main.ts と @"docs/画面 仕様.md" を比較して
|
|
30
|
+
```
|
|
31
|
+
|
|
32
|
+
直接入力もできます。空白を含むパスは二重引用符で囲んでください。候補表示とTab補完は対話端末のみですが、行入力モードでも入力したパスは使えます。`\@` と書けばファイル参照として扱われません。
|
|
33
|
+
|
|
34
|
+
Enterで送信したときにファイルの内容を読み込み、依頼文と一緒にモデルへ渡します。対象は作業ルート内のUTF-8テキスト(8件、合計128 KiBまで)です。PDFは `/pdf` を使ってください。ファイルを読み込めなければ送信を止め、対話端末では入力欄に依頼を戻します。
|
|
35
|
+
|
|
36
|
+
添付内容はセッション履歴にも保存されます。機密情報を含むファイルを指定するときは、モデルの送信先と履歴の保存に注意してください。
|
|
37
|
+
|
|
38
|
+
## Macで画像を送る
|
|
39
|
+
|
|
40
|
+
1. スクリーンショットや画像そのものをクリップボードへコピーします。
|
|
41
|
+
2. MODKHの会話入力欄で **Ctrl+V** を押します。
|
|
42
|
+
3. 「画像を読込中…」の後に **画像1枚** などの添付表示を確認します。
|
|
43
|
+
4. 必要なら説明を入力し、Enterで送信します。画像だけでも送信できます。
|
|
44
|
+
|
|
45
|
+
画像がない、読み取れない、大きすぎる場合は入力欄に理由を表示します。既存のテキストと他の添付画像は消しません。Ctrl+Xで最後の画像を削除できます。読込中の送信は行わず、完了後のEnterを待ちます。Ctrl+Cによる入力取消や終了時は、読込を中止し、遅れて届いた画像を追加しません。
|
|
46
|
+
|
|
47
|
+
画像貼り付けは現在macOSのみ対応しています。macOS標準のAppKitと `osascript` を使い、PNGまたはTIFFの画像データを読み取ります。TIFFはPNGに変換します。ファイルパスやURL、クリップボードのテキストを画像として読み込むことはありません。端末やOSの権限制限で失敗する場合もエラーとして表示します。
|
|
48
|
+
|
|
49
|
+
上限は **4枚、1枚5 MiB、4,000万画素**です。テキストは128 KiBまでです。上限超過を黙って切り捨てたり、画像を外してテキストだけ送信し直したりしません。
|
|
50
|
+
|
|
51
|
+
## モデル・保存先について
|
|
52
|
+
|
|
53
|
+
- **画像に対応したモデル**へ接続してください。MODKHはAI SDK / OpenAI互換APIおよびChatGPT Responses APIへ画像コンテンツとして渡します。個々の接続先が画像に対応するかはモデル次第です。
|
|
54
|
+
- 非対応モデルやAPIで拒否された場合は、そのエラーを表示します。別モデルへの自動切替や、画像を除いた自動再送はしません。`fixed/scripted` は動作確認用で、画像を理解するモデルではありません。
|
|
55
|
+
- 未接続時の画像や、`/connect` などの操作中の添付は保持します。画像は次の通常の会話送信で親モデルへ渡し、サブエージェントへ自動コピーしません。
|
|
56
|
+
- **送信した画像データもテキストと同じセッション履歴へ保存されます。** 再開時に読み戻せます。失敗した送信も履歴に残ります。機密画像を添付する場合は送信先と履歴の保存に注意してください。
|
|
57
|
+
- 画像の内容やbase64を端末のログに展開せず、添付枚数だけを表示します。画像を自動でメモリサービスへ渡すことはありません。
|
|
58
|
+
|
|
59
|
+
実端末でのCmd+VとCtrl+Vの挙動は、使用するターミナルのキー設定・クリップボードアクセス権にも依存します。
|
|
60
|
+
|
|
61
|
+
## トークン使用量の表示
|
|
62
|
+
|
|
63
|
+
モデルが使用量を返した場合、入力欄の下に1行で表示します。返さない場合は何も表示しません(推測値は出しません)。
|
|
64
|
+
|
|
65
|
+
```text
|
|
66
|
+
計 4.9M tok · cache 100% · 入 4.5M · 出 410k
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
- `計`: 入力+出力の合計。`入`: 入力トークン(プロバイダーがキャッシュ分を含めて数える場合はその値)。`出`: 出力トークン。
|
|
70
|
+
- `cache`: 入力のうちキャッシュから読んだ割合。入力が0のときは表示しません。キャッシュ読取りが入力に含まれない集計をする接続先では値の意味が変わります。
|
|
71
|
+
- 端末幅が足りないときは右側の項目から落として1行を保ちます。折り返して入力欄を押し下げません。
|
|
72
|
+
- 行入力モード(`MODKH_PLAIN=1`・非TTY)では、各応答の後に `(使用量: …)` として1行出します。
|
|
73
|
+
- 表示はセッション内の累計です。再起動すると0から数え直し、履歴の分は含みません。保存もしません。
|
|
74
|
+
|
|
75
|
+
## 処理中の状態と長い検索結果
|
|
76
|
+
|
|
77
|
+
- 対話画面では現在の状態と、その状態に入ってからの経過秒数を表示します。ChatGPT 接続ではサーバーが要求を受理すると表示が切り替わります。推論やツール要求の開始が届くとその状態に切り替わり、ツール名が分かれば実行前から表示します。Ctrl+Cで中止できます。
|
|
78
|
+
- 対話画面では回答が終わると、お祝いのAAが1枚出ます。10種類が一巡するたびに順番が変わります。中断やエラーのときは、その理由を表示します。
|
|
79
|
+
- `search_files` はGit管理下ではGitの除外設定を適用します。Git管理外では `.git`、`node_modules`、`.agenticreplay`、`dist` などの生成・管理ディレクトリを除外します。最大50件・出力16 KiBで、長い行は一致箇所の周辺だけを省略表示します。探索上限や読めなかったファイルも明示します。
|
|
80
|
+
- 長いツール結果はモデル入力に限って1件16 KiB、ツールメッセージ1件の本文を合計128 KiBに制限します(省略注記やメッセージ構造は別)。省略は明示し、呼び出しIDと成功・失敗・結果不明の状態は保ちます。セッションの原記録は削除・上書きしません。
|
|
81
|
+
- 長い会話は、直近のターンを残してモデル入力だけを[自動圧縮](context-efficiency.md#会話履歴の自動圧縮)します。圧縮中は Ctrl+C で中止できます。
|
|
82
|
+
- この版以降はエラーの説明も状態イベントに最大2,048文字で残し、再開時に表示します。過去の版で保存されなかったAPIエラーの詳細は復元できません。
|
|
83
|
+
|
|
84
|
+
再開する場合は元の作業ディレクトリで `node dist/index.js chat --resume <セッションID>` を実行し、必要なら `/connect` で再接続します。ビルド更新は、すでに起動中のプロセスや別途インストールしたグローバル版へは自動反映されません。
|
|
85
|
+
|
|
86
|
+
## ツール表示と詳細
|
|
87
|
+
|
|
88
|
+
TUIでは操作名・対象・結果を短く表示します。作成するファイルの本文、長いJSON、読み込んだ手順の全文は通常表示に流しません。
|
|
89
|
+
コマンドの終了コード、失敗・未実行・結果不明、診断の要約は残します。
|
|
90
|
+
`/tools` で直近20件のツール履歴を表示し、`/tools <番号>` でその呼び出しの引数と結果を全文表示できます。
|
|
91
|
+
これは表示だけの整理です。モデルに渡す結果やセッション原記録はこの表示処理で省略しません。行入力モードは従来の出力を保ちます。
|
|
92
|
+
|
|
93
|
+
## browseによるブラウザ検証
|
|
94
|
+
|
|
95
|
+
PATH上に実行可能な `browse` がある場合、コマンドツールの説明にブラウザ操作の経路を追加します。
|
|
96
|
+
コマンド権限のある親・子エージェントに共通して適用し、権限のない担当にはコマンド権限を追加しません。
|
|
97
|
+
`browse --help` と `browse status --json` で使い方・接続状態を確認し、`browse execute` などで操作します。
|
|
98
|
+
プロジェクト内のPlaywrightパッケージがないことと、browse経由でブラウザ操作できないことを区別します。
|
|
99
|
+
実行ファイルの検出だけでは拡張機能の接続を保証せず、インストールやペアリングも自動では行いません。
|
|
100
|
+
|
|
101
|
+
### 使用中の表示
|
|
102
|
+
|
|
103
|
+
`browse` ツールの呼び出しが実行中の間、トークン使用量と言語サーバーの並びに `browse in use` を出します。
|
|
104
|
+
親・子・`/agents run` のどの経路でも同じ表示になります。呼び出しが終わると消えます。
|
|
105
|
+
|
|
106
|
+
- 表示は実行中かどうかだけで、接続状態や操作の成否は表しません。接続確認は `browse status --json` で行います。
|
|
107
|
+
- 端末が右欄を置けない幅・高さでは、入力欄下の状態行の末尾に `· browse in use` を付けます。
|
|
108
|
+
- 行入力モード(`MODKH_PLAIN=1`・非TTY)では、開始と終了を1回ずつ `(browse in use)` と `(browse 終了)` で出します。
|
|
109
|
+
- 表示はツールの権限・承認・記録を変えません。モデルに渡す結果も同じです。
|
|
110
|
+
|
|
111
|
+
## PDFを見ながら実装する
|
|
112
|
+
|
|
113
|
+
画像対応モデルに接続して、会話入力欄で次のように依頼します。行入力モードでも使えます。
|
|
114
|
+
|
|
115
|
+
```text
|
|
116
|
+
/pdf @docs/画面仕様.pdf
|
|
117
|
+
/pdf --pages 5-7 @"docs/画面 仕様.pdf" | この3ページにある入力項目と検証条件を反映して
|
|
118
|
+
```
|
|
119
|
+
|
|
120
|
+
対話端末で `/pdf @` と入力すると、作業ルート内のPDFとフォルダーが候補に出ます。**↑↓** で選び、**Tab** で補完します。空白を含むパスは `@"パス"` と指定します。`@` で指定すると `| 依頼文` を省略でき、省略時はPDFの要約を依頼します。従来の `/pdf パス | 依頼文` も使えます。
|
|
121
|
+
|
|
122
|
+
ページ番号は1から始まり、単独ページは `--pages 5` と指定します。範囲を省くと全ページが対象です。
|
|
123
|
+
|
|
124
|
+
PDFはローカルで変換します。macOSでは `brew install poppler`、Ubuntuでは `sudo apt install poppler-utils` で必要なコマンドを導入できます。選んだ各ページのテキストと、図・写真・配置を含むページ全体のPNGを親モデルに送り、会話履歴にも保存します。スキャンした資料はページ画像をモデルが読み取ります。
|
|
125
|
+
|
|
126
|
+
PDFは32 MiBまで。1回に送れるページ数は貼り付け済みの画像と合わせて4枚までで、超過時はページ範囲を指定し直せます。各ページの画像は長辺1600ピクセル、本文は1ページ32 KiBまでです。
|
|
@@ -0,0 +1,117 @@
|
|
|
1
|
+
# 言語解析(LSP・tree-sitter)
|
|
2
|
+
|
|
3
|
+
MODKHは対象ファイルの言語を検出し、必要な解析器だけを準備して、読み取り・編集・調査に使います。利用者が毎回「LSPを使って」と指示したり、言語ごとにインストールする必要はありません。
|
|
4
|
+
|
|
5
|
+
## 自動で起きること
|
|
6
|
+
|
|
7
|
+
| 契機 | 実行内容 |
|
|
8
|
+
| --- | --- |
|
|
9
|
+
| 対象ファイルの初回 `read_file` | 言語検出、構文解析、言語サーバーの準備要求、構造と診断を本文に付記 |
|
|
10
|
+
| `create_file` / `edit_file` 成功後 | 新内容で再解析し、LSPへ同期して診断を取得 |
|
|
11
|
+
| `code_outline` など | 構文構造・定義・参照・ホバーを取得 |
|
|
12
|
+
| セッション終了 | 起動した言語サーバーをすべて停止 |
|
|
13
|
+
|
|
14
|
+
解析は**補助情報**です。解析が失敗・タイムアウトしても、読み取りや編集の成否は変わりません。編集が成功したあとに解析だけが失敗しても、二重編集はしません。
|
|
15
|
+
|
|
16
|
+
初期値では、同時に起動する言語サーバーは3台までです。上限を超えると最も長く使っていないサーバーを停止します。
|
|
17
|
+
|
|
18
|
+
## 対応状況
|
|
19
|
+
|
|
20
|
+
実サーバー・実WASMで起動と診断を確認したものだけを「実証済み」としています。実証していないものは未検証です。
|
|
21
|
+
|
|
22
|
+
| 対象 | 構文解析(WASM同梱) | 言語サーバー | 実証状況 |
|
|
23
|
+
| --- | --- | --- | --- |
|
|
24
|
+
| TypeScript / JavaScript / TSX | あり | typescript-language-server(自動導入) | 実証済み(型エラー検出・編集後の解消・再利用) |
|
|
25
|
+
| CSS | あり | vscode-css-language-server(自動導入) | 実証済み(構文エラー検出) |
|
|
26
|
+
| HTML | あり | vscode-html-language-server(自動導入) | 起動・診断取得は実証済み。不正HTMLを診断0件とする仕様は実測どおり |
|
|
27
|
+
| Python | あり | basedpyright(自動導入) | 起動・診断は未実証 |
|
|
28
|
+
| Rust / C / C++ | あり | rust-analyzer / clangd(既存実行ファイルのみ) | 起動・診断は未実証。toolchainが無い場合は意味解析を縮退 |
|
|
29
|
+
| Ruby / Swift / PHP | あり | ruby-lsp / sourcekit-lsp / PHPantom(既存実行ファイルのみ) | 未実証。SDKやgemが無い場合は縮退 |
|
|
30
|
+
| Svelte | **なし** | svelte-language-server(自動導入) | 文法WASMが未収録のため構文解析は縮退。意味解析は未実証 |
|
|
31
|
+
| Tailwind CSS | ホスト言語の文法 | @tailwindcss/language-server(自動導入) | 未実証 |
|
|
32
|
+
| Common Lisp | **なし** | CL-LSP(既存実行ファイルのみ) | 未実証。マクロ展開や評価は行わない |
|
|
33
|
+
|
|
34
|
+
Svelte・Common Lisp は文法WASMを同梱していないため、`code_outline` などは「対象外」と理由を返します。本文の読み書きは通常どおりできます。
|
|
35
|
+
|
|
36
|
+
## 導入と保存先
|
|
37
|
+
|
|
38
|
+
- 解析器は `MODKH_HOME`(既定は `~/.config/modkh`)配下の `language/` に置きます。対象プロジェクトの依存・lockfileは変更しません。
|
|
39
|
+
- npm系は専用prefixと専用キャッシュへ導入し、`--ignore-scripts` で導入時のコード実行を避けます。プロジェクトや利用者のnpmキャッシュは変更しません。
|
|
40
|
+
- 導入先は一時領域に作り、検証後に原子的に公開します。同時導入はロックで排他します。
|
|
41
|
+
- 導入した版・取得元・検証時刻は `language/state.json` に記録します。毎起動時にlatestを取り直しません。
|
|
42
|
+
- 失敗はその言語だけの縮退です。記録した失敗を同じターンで無限に再試行しません。
|
|
43
|
+
|
|
44
|
+
### 操作コマンド
|
|
45
|
+
|
|
46
|
+
```sh
|
|
47
|
+
modkh language status # 検出・導入状態・文法の有無
|
|
48
|
+
modkh language install # すべての宣言済み言語を導入(手操作は通常不要)
|
|
49
|
+
modkh language install --detected # 検出した言語だけ
|
|
50
|
+
modkh language retry <id> # 失敗記録を消して再試行
|
|
51
|
+
modkh language update # 導入済みサーバーと文法を検証し直す
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
通常利用ではこれらは不要です。最初の読み取りで自動的に準備します。
|
|
55
|
+
|
|
56
|
+
## 設定
|
|
57
|
+
|
|
58
|
+
`config.json` の `language` で調整できます。不正な値は既定へ戻します。
|
|
59
|
+
|
|
60
|
+
```json
|
|
61
|
+
{
|
|
62
|
+
"language": {
|
|
63
|
+
"autoInstall": true,
|
|
64
|
+
"disabled": ["ruby"],
|
|
65
|
+
"installTimeoutMs": 180000,
|
|
66
|
+
"requestTimeoutMs": 20000,
|
|
67
|
+
"servers": {
|
|
68
|
+
"python": { "command": "/opt/homebrew/bin/pyright-langserver", "args": ["--stdio"] }
|
|
69
|
+
}
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
- `autoInstall: false` にすると自動導入しません。既存サーバーだけを使います。
|
|
75
|
+
- `servers` は言語ごとの明示指定です。指定した実行ファイルを優先します。
|
|
76
|
+
- `disabled` の言語は解析しません(本文操作は可能)。
|
|
77
|
+
|
|
78
|
+
## ツール
|
|
79
|
+
|
|
80
|
+
`search_files` は文字列検索として残ります。シンボル調査では次を優先します。
|
|
81
|
+
|
|
82
|
+
- `code_outline`: 関数・クラスなどの一覧と宣言全体の範囲
|
|
83
|
+
- `code_syntax_search`: ファイル内の宣言名を部分一致で絞り、同名候補ごとに宣言全体の範囲を返す
|
|
84
|
+
- `code_definition` / `code_references` / `code_hover`: 位置的問い合わせ
|
|
85
|
+
- `code_diagnostics`: 現在の内容を同期して診断を取得
|
|
86
|
+
|
|
87
|
+
構文ツールの行と桁は1から数え、終了位置は範囲に含めません。編集時は、返された範囲で現行ソースを確認してから変更します。定義や参照の問い合わせには、行末の「名前位置」を言語サーバーのツールに渡せます。
|
|
88
|
+
|
|
89
|
+
## 状態の区別
|
|
90
|
+
|
|
91
|
+
診断について次の3状態を混同しません。
|
|
92
|
+
|
|
93
|
+
- **診断0件**: サーバーが現在の版に対して「問題なし」を通知した
|
|
94
|
+
- **未通知**: まだ結果が来ていない(成功ではない)
|
|
95
|
+
- **古い版**: 通知された版が現在の内容より古い(現在の診断として返さない)
|
|
96
|
+
|
|
97
|
+
文書を変更したときは版を進め、古い版の診断は捨てます。同じ内容の再解析では版を進めません。
|
|
98
|
+
|
|
99
|
+
## 境界と制約
|
|
100
|
+
|
|
101
|
+
- 位置はLSP仕様のUTF-16単位です。UTF-8バイト位置とは異なります。CRLFも変換しません。
|
|
102
|
+
- サーバー発の `workspace/applyEdit` は適用しません。編集は必ず承認付きツール経由です。
|
|
103
|
+
- ファイルツールのルート制限は、外部LSPプロセス自体を隔離するものではありません。サーバーは利用者権限で動きます。
|
|
104
|
+
- 2 MiBを超えるファイルは解析しません(本文操作は可能)。
|
|
105
|
+
- XcodeやOS管理者権限が必要なSDKは自動取得しません。前提不足として表示します。
|
|
106
|
+
- 実端末・実サーバーでの検証はmacOS arm64が中心です。Linux等は別途検証が必要です。
|
|
107
|
+
|
|
108
|
+
## 検証
|
|
109
|
+
|
|
110
|
+
```sh
|
|
111
|
+
npm run typecheck
|
|
112
|
+
npm test
|
|
113
|
+
npm run build
|
|
114
|
+
sh scripts/acceptance.sh
|
|
115
|
+
```
|
|
116
|
+
|
|
117
|
+
`npm run build` は文法WASMを `dist/language/grammars/` へ同梱します(約20MB)。`scripts/acceptance.sh` は隔離環境へ配布物を導入し、空の管理領域からの自動導入、実際の型エラー診断、再利用時に再導入しないこと、修正後に診断が消えること、`language status` が状態を変更しないことを確認します。
|
package/docs/models.md
ADDED
|
@@ -0,0 +1,109 @@
|
|
|
1
|
+
# モデル接続と ChatGPT ログイン
|
|
2
|
+
|
|
3
|
+
## モデル参照と選択画面
|
|
4
|
+
|
|
5
|
+
`modkh` を起動し、`/connect` で OpenAI / OpenCode Zen / OpenCode Go / Ollama Local / Ollama Cloud / OpenRouter / Infron / Hermes Agent を選ぶ。
|
|
6
|
+
TTYでは入力で検索、↑↓で選択、Enterで決定、Escで戻る。OpenAIではChatGPT OAuthとAPIキーを選べる。
|
|
7
|
+
APIキーは環境変数を優先し、未設定ならTTYで伏せ字入力できる。入力したキーは `keys.json`(0600)に保存し、次回起動時に再利用する。
|
|
8
|
+
OpenAIのモデル一覧は選択画面を開くたびに公式から取得する。APIキーでは `https://api.openai.com/v1/models`、
|
|
9
|
+
ChatGPT OAuthでは公式Codexと同じ `https://chatgpt.com/backend-api/codex/models` を使い、アカウントに返されたモデルIDを表示する。
|
|
10
|
+
`/models openai`、`/models chatgpt` でも再取得できる。取得中はCtrl+Cで中止でき、失敗時は理由を表示する。
|
|
11
|
+
古い固定リストや保存済み一覧へのフォールバックは行わない。再度開いて取得し直すか、モデルIDを直接指定できる。
|
|
12
|
+
`/models` では、保存済みのAPIキー・環境変数のAPIキー・ChatGPTのOAuth認証で使える接続先のモデルをまとめて選べる。
|
|
13
|
+
`/models <検索語>` で接続先をまたいで絞り込める。接続先の名前を指定すると、その一覧だけを取得する。
|
|
14
|
+
他のプロバイダーも同じ方針で、`/connect` と `/models` を開くたびに各プロバイダーの一覧APIから取得する。
|
|
15
|
+
AIプロバイダーはモデルの追加・廃止が多いため、組み込みの固定モデル一覧は持たない。
|
|
16
|
+
`fixed/scripted`(オフライン検証用)だけは取得元が無いため常に候補に出す。
|
|
17
|
+
|
|
18
|
+
`chat --model <provider>/<model>`、または `/connect <provider>/<model> [--base-url <url>]` で直接指定もできる。
|
|
19
|
+
接続に失敗しても別の接続先へ自動で切り替えない。モデルの選択だけではAPI到達や利用権限は検証されない。
|
|
20
|
+
|
|
21
|
+
## 選んだモデルの保存と次回起動
|
|
22
|
+
|
|
23
|
+
`/connect` や `/models` で接続したモデル(と `--base-url`)は `config.json` に保存され、次回の起動はそのモデルで開く。
|
|
24
|
+
`--model` を渡したときはそちらが優先。`--resume` はセッション自身の接続を最優先する。`fixed/*` は検証専用なので保存しない。
|
|
25
|
+
|
|
26
|
+
復元には認証情報も要る。TTYで入力したAPIキーは `keys.json`(0600)に保存され、次回起動時に自動で読まれる。
|
|
27
|
+
環境変数だけで接続した場合はキーが保存されないため、その環境変数を外した状態で起動すると復元できない。
|
|
28
|
+
そのときは「保存済みキーが無い」と表示するので、`/connect <provider>` で1度キーを保存すれば以降は自動で復元される。
|
|
29
|
+
|
|
30
|
+
`config.json` は一時ファイルに書いてから置き換えるため、強制終了で途中まで書かれた状態を残さない。
|
|
31
|
+
万一JSONが壊れていても `model` など復元に必要な値は読み取り、壊れた内容は `config.json.broken` に退避する。
|
|
32
|
+
手書きした未知のキーは保存時に保持される。
|
|
33
|
+
|
|
34
|
+
| Provider | 認証 | 既定URL・設定 |
|
|
35
|
+
| --- | --- | --- |
|
|
36
|
+
| `openai` | `OPENAI_API_KEY` | OpenAI API |
|
|
37
|
+
| `opencode` | `OPENCODE_API_KEY` | `https://opencode.ai/zen/v1` / `OPENCODE_BASE_URL` |
|
|
38
|
+
| `opencode-go` | `OPENCODE_API_KEY`(Zenと共通) | `https://opencode.ai/zen/go/v1` / `OPENCODE_GO_BASE_URL` |
|
|
39
|
+
| `ollama`(Local) | 不要 | `http://127.0.0.1:11434/v1` / `OLLAMA_BASE_URL` |
|
|
40
|
+
| `ollama-cloud` | `OLLAMA_API_KEY` | `https://ollama.com/v1` / `OLLAMA_CLOUD_BASE_URL` |
|
|
41
|
+
| `openrouter` | `OPENROUTER_API_KEY` | `https://openrouter.ai/api/v1` |
|
|
42
|
+
| `infron` | `INFRON_API_KEY` | `https://llm.onerouter.pro/v1` / `INFRON_BASE_URL` |
|
|
43
|
+
| `hermes` | `HERMES_API_KEY` | `http://127.0.0.1:8642/v1` / `HERMES_BASE_URL` |
|
|
44
|
+
| `chatgpt` | ChatGPT OAuth | `https://chatgpt.com/backend-api/codex/responses` |
|
|
45
|
+
|
|
46
|
+
既存の `anthropic` / `google` / `deepseek` / `groq` / `xai` / `lmstudio` も直接指定と `/models` から利用できる。
|
|
47
|
+
`compatible/<model> --base-url <url>` は任意のOpenAI互換API、`fixed/scripted` はオフライン検証専用。
|
|
48
|
+
|
|
49
|
+
HermesはモデルAPIではなく、サーバー側でツールを実行する別エージェント。
|
|
50
|
+
Hermes側の `API_SERVER_KEY` をMODKHの `HERMES_API_KEY` に指定する。
|
|
51
|
+
MODKHの個別承認やStopでリモートの副作用を制御・停止できる保証はないため、接続時に確認画面を出す。
|
|
52
|
+
|
|
53
|
+
## Ollama Local / Cloud
|
|
54
|
+
|
|
55
|
+
`/connect` には **Ollama Local** と **Ollama Cloud** を別々に表示する。
|
|
56
|
+
ローカルは従来どおり `/connect ollama`。クラウドは `/connect ollama-cloud` でキーとモデルを選ぶ。
|
|
57
|
+
`/models ollama-cloud` でもクラウド候補に絞り込める。
|
|
58
|
+
|
|
59
|
+
どちらの候補も固定値ではなく、`/v1/models` から取得した最新の一覧をそのまま並べる。
|
|
60
|
+
取得できなければ理由を表示し、モデルIDの直接入力を案内する。モデルの利用可否は送信時に確認する。
|
|
61
|
+
[公式の直接接続手順](https://docs.ollama.com/api/openai-compatibility)に従い、
|
|
62
|
+
`https://ollama.com/v1` と `OLLAMA_API_KEY` を使う。ローカルOllamaのインストール・サインインは不要。
|
|
63
|
+
直接APIでは `:cloud` 接尾辞を付けず、[API一覧のモデル名](https://ollama.com/api/tags)をそのまま使う。
|
|
64
|
+
`OLLAMA_BASE_URL` はLocalだけ、`OLLAMA_CLOUD_BASE_URL` はCloudだけに適用する。
|
|
65
|
+
Cloudのキー未設定・通信失敗時にLocalへ自動で切り替えない。
|
|
66
|
+
|
|
67
|
+
## OpenCode Zen / Go
|
|
68
|
+
|
|
69
|
+
`/connect` には **OpenCode Zen** と **OpenCode Go** を別々に表示する。
|
|
70
|
+
どちらも同じ `OPENCODE_API_KEY` を使うため、片方で入力したキーがもう片方にも適用される
|
|
71
|
+
(保存名は `opencode` に寄せ、旧版が `opencode-go` で保存したキーも読み替える)。
|
|
72
|
+
|
|
73
|
+
| 接続先 | ベースURL | 差し替え用の環境変数 |
|
|
74
|
+
| --- | --- | --- |
|
|
75
|
+
| Zen | `https://opencode.ai/zen/v1` | `OPENCODE_BASE_URL` |
|
|
76
|
+
| Go | `https://opencode.ai/zen/go/v1` | `OPENCODE_GO_BASE_URL` |
|
|
77
|
+
|
|
78
|
+
Go は会話ごとの安定したセッションIDを要求し、無い場合は `400 MissingSessionID` を返す。
|
|
79
|
+
MODKHは `x-opencode-session` にプロセス単位のIDを、`user-agent` に `modkh/<version>` を付けて送る。
|
|
80
|
+
モデル一覧は両方とも `GET /models` から取得する(ZenとGoで内容は異なる)。
|
|
81
|
+
|
|
82
|
+
## Sign in with ChatGPT
|
|
83
|
+
|
|
84
|
+
```sh
|
|
85
|
+
modkh auth login chatgpt
|
|
86
|
+
# またはMODKH内で /connect → OpenAI → ChatGPT
|
|
87
|
+
```
|
|
88
|
+
|
|
89
|
+
- PKCE (S256) とランダムなstateを使い、`https://auth.openai.com/oauth/authorize` で認証する。
|
|
90
|
+
- ローカルの `http://127.0.0.1:1455/auth/callback` を待ち受けてからブラウザを開く。
|
|
91
|
+
- 正しいパス・stateのコールバックだけを受理し、`/oauth/token` で一度だけ交換する。
|
|
92
|
+
- トークンを `$MODKH_HOME/chatgpt-auth.json`(既定 `~/.config/modkh/`)へ0600で保存した後、ブラウザに成功を表示する。
|
|
93
|
+
- ポート使用中、認証拒否、交換エラーは端末に表示する。他プロセスは停止しない。Ctrl+Cで中止でき、コールバックサーバーも閉じる。
|
|
94
|
+
- ブラウザが自動で開かなければ表示URLを手動で開く。SSH・コンテナではコールバックへ到達できる構成が必要。
|
|
95
|
+
- 期限切れの認証は次の送信前に更新する。更新失敗時は `/connect chatgpt` で再認証する。モデル要求を自動再送しない。
|
|
96
|
+
- ChatGPT用トークンはCodex Responsesへ送信する。通常のOpenAI APIキー用エンドポイントとは分離する。
|
|
97
|
+
`store: false`、フラットな `type: "function"` のツール定義を使う。
|
|
98
|
+
|
|
99
|
+
## 検証範囲と参照
|
|
100
|
+
|
|
101
|
+
実OAuthログインや有料モデルへのライブ送信は未検証。ローカルの偽HTTPサーバーで
|
|
102
|
+
PKCE・コールバック・交換・保存・キャンセル・ポート競合・期限切れ更新とCLI接続を検証する。
|
|
103
|
+
TTY入出力ストリームの統合テストに加え、`scripts/terminal-acceptance.py` は実PTYで操作する。
|
|
104
|
+
PTY権限のないサンドボックスでは後者を実行できない。
|
|
105
|
+
|
|
106
|
+
- [OpenAI CodexのOAuth実装](https://github.com/openai/codex/blob/main/codex-rs/login/src/server.rs)
|
|
107
|
+
- [OpenCode Console](https://opencode.ai/docs/console/models/)
|
|
108
|
+
- [Infron OpenAI-compatible API](https://infron.ai/docs/llm-apis/openai-compatible-api/overview)
|
|
109
|
+
- [Hermes Agent API server](https://hermes-agent.nousresearch.com/docs/user-guide/features/api-server)
|