Modus 開発と文書作成
これは Modus フレームワーク自体 にサービスを提供する複合スキルです。一つのエントリが全体認識、モジュール開発、テスト公開、記事執筆を繋ぎます。モジュールガイドはタスクに応じて読み込まれ、リファレンスディレクトリ全体を一度にコンテキストに詰め込むことはありません。
最初に現在のプロジェクトを特定する
ソースコードの場所はユーザーが指定したチェックアウトを優先します。未指定の場合は現在の Git リポジトリのルートを使用します。本スキルのディレクトリは、読み込まれた SKILL.md の場所によって決定されます。最初にチェックアウトに入る際、SKILL_DIR を本スキルのディレクトリに設定し、Modus リポジトリのルートで読み取り専用の診断を実行します。
python3.11 "$SKILL_DIR/scripts/inspect_repository.py" --root .
これはブランチ、HEAD、上流、ローカル変更、パッケージバージョンと知識ベースの乖離をチェックします。ネットワーク接続は行わず、リポジトリに書き込まず、インストール済みの Modus を呼び出しません。任意の Python 3.11+ インタプリタを使用でき、実際の環境に応じて例の python3.11 を置き換えてください。
知識スナップショットは modus-open / 49c51621f378a58d6724eedde4657d9505346d45（配布パッケージ openmodus 0.0.4）から取得されます。異なるブランチ、バージョン、またはファイルの変更は、関連ガイドが現在の実装と照合する必要があることを意味します。ブランチを自動で切り替えたり、個人の CLI をアップグレードしたり、プロジェクト知識を生成したりしないでください。
最初に 全体概要 を読み、次に以下の表に従ってガイドを選択してください。プロジェクトに既に精通しておりタスクが明確な場合は、該当モジュールに直接進んでください。
タスクルーティング
| 現在のタスク | 読み込み先 |
|---|---|
| 機能開発、修正、リファクタリング、ソースコードレビュー | 開発フロー + 該当モジュール + 検証と公開 |
| ヘルプ、引数、終了コード、日本語エクスペリエンス、個人パッケージメンテナンス | CLI とメンテナンスエントリ |
| 導入、アップグレード、アンインストール、マニフェスト、アセット競合、Git プロテクション | プロジェクトインストールと所有権 |
| CodeBuddy / Claude / Cursor / Codex 導入、起動フック | プラットフォームとフック |
| ソースコード発見、フリーズ、パース、コンパイラ、言語拡張、キャッシュヒット | N1–N2：ソースと観測 |
| 識別子解決、呼び出し関係、トポロジ、エントリからエフェクト、能力トラバース | N3–N4：解決と能力 |
| スコープ候補、クラスタリング提案、エビデンスパケット、コンテキスト、カーソル、サマリー | N5–N6：投影と配信 |
| 現在のプロジェクトコンテキスト、知識ルーティング、ランキング、ソースへのフォールバック、予算 | 検索とオーケストレーション |
| Markdown アイデンティティ、CAS、知識更新、アンカー、完全性と公開検証 | 知識書き込みと検証 |
| init/reinit/update/sync 動作、本文生成、スコープ確認、テンプレート | 知識作成ワークフロー |
| 複数リポジトリワークスペース、メンバーアドレッシング、外部ナビゲーション、分離 | ワークスペース |
| wheel、ソースパッケージ、依存関係、CI、テスト選択 | 検証と公開 |
| 記事、レポート、技術紹介、発表アウトライン、アーキテクチャ図 | ソースコード根拠と文書作成；関連するメカニズムは該当モジュールと併読 |
| iwiki、旧資料、または本スキルの根拠の確認 | ソースと差分 |
最も変更しやすい境界
- Modus のインストール導入、初期化エビデンス、長期 Markdown 知識はそれぞれ異なる所有者を持ちます。
modus initはアセットをインストールします；/modus-initはアシスタントが調査し知識を作成します。 - 通常の検索は現在のソースコードと正式な Markdown を読みます。初期化分析キャッシュは日常実行の事実上のソースにはなりません；新機能を追加する際に
machineを通常の CLI パスにインポートしないでください。 - N1–N6 は決定論的なエビデンス処理、K1–K6 はアシスタントの意味論的な作成です。能力の組み合わせは LLM を呼び出さず、候補と代表パスは正式なドメインや完全な実行パスと等価ではありません。
- インストール/更新トランザクションと知識更新の失敗セマンティクスは異なります。知識更新はファイル単位でコミットされ部分的な成功を報告しますが、バッチ全体のロールバックは保証できません。
.modus/とホストコピーは管理された導入アセットです；modus/knowledge/は長期知識です；手動のconstraint/、references/business/は独立した保護があります。cleanはチェッカーがカバーする完全性または公開の約束のみを証明し、本文の真実性、完全性、明確性、または実行時の成功を証明しません。- コマンド、JSON フィールド、ステータスコード、安定 ID と日本語表示は別々に管理されます。テンプレートはパッケージに付属する製品動作の契約です。
タスク完了
開発結果は、具体的な動作、変更の所有者、実際の検証、検証されていない境界を説明します。文書作成結果は、現在の実装、設計目標、過去の資料、効果のエビデンスを分けて提示します。本スキルを参照することで位置特定を加速できますが、実装の結論は現在のソースコードを再読して導き出す必要があります。
本スキルはその後の開発をサポートしますが、公開、コミット、プッシュ、外部ドキュメントへの書き込み、または委任権限を付与するものではありません；これらのアクションは現在のユーザータスクの認可に従います。本スキルを使用したからといって、自動的に知識を再構築したり、スキルを更新したり、無関係なアセットを変更したりしないでください。