# Astra セットアップ v1.2 **2026-09-11改訂｜Codexのローカル作業向け｜設定手順と共通指示をまとめた1ファイル** このファイルをCodexへ添付して、次の一文を送ってください。 > このファイルに沿って、Codexの無駄な読み込みや作業を減らして。個人の設定とモデル・推論の強さは維持し、記載の設定を適用して。変更内容・確認結果・戻し方も教えて。 参考資料と短い依頼から、必要な仕事を完成まで進めやすくする設定です。常用する指示を短くし、無関係な過去情報、Skillの誤起動、長いツール出力、不要な作り込み・過剰なテストを減らします。既存の検索Hookがない環境へ、新しいRAGやObsidianを導入するファイルではありません。 ファイルを開いただけでは設定されません。ファイル操作ができるローカルのCodexで、設定を依頼してください。通常のChatGPTへ添付しても、パソコンのCodex設定は変わりません。Astraの利用権、Canvaや動画生成APIなどへの接続・権限・費用は別です。 ## 実際に変えるところ | 対象 | 入れる変更 | |---|---| | 毎回読む共通指示 | 重複を統合し、業務別の長い手順は必要時だけ読む。仕事を最後まで進める方針は残す | | メモリ・過去ログの使い方 | 関係のない自動挿入・同じ引用の再挿入を抑え、記録中の命令や許可を再実行しない | | 競合する個人管理のSkill | 相談・新規制作・部分修正を分け、単語だけの誤起動や全制作への巻き戻しを直す | | Codexの設定 | サブエージェント無効、承認要求は本人が確認、Skillの不足MCPの導入案内を無効、推論要約を簡潔にする | | 個人管理のHook | 不要な助言の重複を整理。既存の過去情報挿入がある場合だけ、対象・量・重複を絞る | | ツール出力と中間工程 | 必要なキー・範囲だけを返し、巨大JSON・全文ログ・形式的な中間報告を減らす | | 実装・調査・確認の進め方 | 最小限で作り、変更箇所とリスクに見合う確認だけを行い、完了後に作業を増やさない | 既に同じ方針が入っている箇所はそのまま使います。過去ログやメモリの中身は削除しません。本人の保存先・仕事・正本・ツールの選択を保持します。承認の必要条件やサンドボックスは変えず、承認が必要な場合の確認担当を本人へ揃えます。モデル・推論の強さ・速度は現在値を引き継ぎ、この導入を理由に切り替えません。 --- ## 設定を担当するCodexへ 以下は導入時だけ実行する。レビュー・要約だけの依頼では変更しない。利用者が上記の設定を明示的に依頼した場合、その範囲のローカル更新は続けて実行し、同じ許可を再確認しない。製品・管理者の規則、ファイルの管理方法、利用者のより具体的な現行指示を守る。 **手順1〜4は読み取り・判断・差分の作成だけを行う。実ファイルへの変更はすべて、手順5で変更前データのバックアップを完了してから行う。** ### 1. 実際に使われる設定を特定する 実行ホスト、Codexのバージョン、設定ホームを確認する。有効な `CODEX_HOME` があればその場所を使い、なければ通常の `~/.codex` を候補にする。別ホスト・別アプリへ書かない。 グローバルの `AGENTS.override.md` と `AGENTS.md` を確認する。非空のoverrideが優先される構成なら、その既存の入口を対象にする。空ファイルや読み込み順が不明なら、その版の仕様を確認して決める。新しいoverrideで既存指示を隠さない。作業フォルダに適用されるプロジェクト指示は競合確認だけ行い、この導入で変更しない。 `config.toml` は必要なキーと有効プロファイルを確認する。CLIが使えるなら `codex features list` などで対応する機能と現在値を読む。設定値がアプリの起動オプション・管理者設定で上書きされる場合はそれも区別する。トークン、認証ファイル、全セッション、ホーム全体は走査・出力しない。 ### 2. 古い進め方を繰り返す原因を絞る グローバル指示と、それが直接参照する個人管理の指示・Skill、現在登録されているHookを対象に、次の競合を確認する。Skillの全フォルダを無差別に読み込まない。 - 常に多数へ分担する、必ず別モデルへ渡す。 - 過去の失敗手順や古い許可を、今の命令として再実行する。 - 依頼が短いだけで停止し、利用者に全工程を決めさせる。 - 同じ許可を何度も聞く、毎回全履歴を読む、検証を無限に追加する。 - 単語が一致しただけで無関係なSkillや制作工程を始める。 - 各工程の受領書JSONや中間報告が必須となり、実物の確認より、その記録を作って照合する往復が増える。 - 小さな修正でも、汎用化・補助ツール・全機能テスト・全資料の再出力を一律に必須とし、完了後も作り込みや確認が続く。 - 「OK、それで」など対象のない返事で過去ログを検索し、無関係な記録や同じ引用を毎回挿入する。 - ツール結果の巨大JSON・全文ログ・重複メタデータを、必要項目へ絞らず毎回取り込む。 古いログにその記述があるだけなら、ログは残し、常用指示側の扱いを直す。記憶を消すことを改善とみなさない。自動生成メモリ・履歴・配布元管理のSkillは直接改変しない。管理元を修正する必要があれば、具体的な差分案を私有の作業場所に残す。 Hookは、その環境で有効な設定ファイルと登録済みコマンドの対象だけを読む。`UserPromptSubmit` や `PostToolUse` で、毎回同じ文体・思考アドバイスを重ねている個人管理のHookを特定する。目的を共通指示で満たせる場合は、重複する助言を共通指示へ一度だけ統合し、そのHookだけを無効にする差分を用意する。長いという理由だけで無効にしない。 権限・セキュリティ・監査・必須の検証、本人が使っている正本検索・同期の機能は保持する。助言と他の処理を切り分けられない、管理元が不明、または無効化の仕様が未確認なら、その無効化は行わず理由を報告する。`hooks.json` 全体の削除や、Hook機能の一括停止はしない。過去情報の挿入量だけを絞る場合は次の条件に従う。仕様は導入版に合わせ、記事のJSON例を推測で移植しない。 **過去情報を自動挿入するHookが既にある場合だけ：** Codex側の登録と実装を読み、次の調整を既存の仕組みでできる範囲に絞って差分にする。 - 相づち・対象のない続行依頼では検索を省き、具体的な話題がある場合だけ検索する。候補の順位スコアだけを関連性の確率とみなさず、話題との一致も確かめる。 - 初回は最大3件・本文各350字・全体1,800字程度を目安にし、不足は通常の検索で補えるようにする。全文確認が必要な仕事までこの量へ固定しない。 - 同じ会話の同じ検索・引用を繰り返さない。圧縮や会話のクリア後は再取得できるようにし、別の会話と状態を共有しない。記録が必要なら本文・秘密を保存せず、短期間の識別用ハッシュ等に限定する。 - 正本・検索CLI・手動検索・同期・既存の安全フィルターは保持する。他のアプリと実装を共有している場合はCodex側だけに適用する。新しい分類AI・常駐サーバー・DBや新規Hookは作らない。登録がない／管理元が不明な場合は、このHook調整を省く。 本人が直接管理するSkillは、今回と明確に競合する説明文・一文だけを整理する。相談では制作を始めず、部分修正では変更箇所と直接影響する範囲だけを扱い、既存形式・デザインを保つ。通常の共有・公開へ電子署名固有の確認を適用しない。必要な安全確認は残し、配布元管理のSkillや他アプリの設定へ広げない。新設・大量削除・一括無効化はしない。 ### 3. 常用指示を意味で統合する 後半の `ASTRA_CORE_START` と `ASTRA_CORE_END` の間だけを統合候補にする。導入手順・この表・例文・バックアップ記録を毎回読む指示に混ぜない。 同じ意味の方針を二重に追加しない。本人の言語、仕事、保存先、正本、出力形式、ツールの使い分け、組織の規則を引き継ぐ。全文置換や末尾への全文追記を避け、足りない方針を関連箇所へ統合する。既存の重複段落・同じ注意の反復を一つにまとめる。特定業務の長い手順は既存の管理先を優先し、なければ本人の指示管理先に必要な参照Markdownだけを作って分離できる。常用指示には「どの作業で、どのファイルを読むか」を残し、リンク先に元の条件が保たれていることを確認する。全参照の一括読み込みや新しいoverrideは作らない。文量の削減率をノルマにして必要な規則を落とさない。配布元の個人情報・会社のID・絶対パスを持ち込まない。 SkillやPluginは数だけで削除しない。関係のないものまで自動起動する登録・指示があれば、その誤起動を止める。認証済み連携を解除したり、未使用と推測したPluginを一括アンインストールしたりしない。 PersonalAX等の管理区画や生成元があれば、既存の更新方法を使う。管理された生成物だけを上書きしない。今回の明示依頼と競合する古い汎用ルールは今回の方針へ整理する。ただし本人の特定業務向けの明示ルールか判断できない場合は、その競合箇所に絞って説明し、他の変更を先に進める。 ### 4. 具体的な動作設定を揃える この配布版は単体実行を標準にする。適用するのは以下の4キー。実行中のモデル、推論強度、速度、承認が必要になる条件、サンドボックス、既存MCP接続は変更しない。管理者の強制設定や、利用者のより具体的な現行指示がある箇所はそれを守り、反映範囲を報告する。 対応が確認できた `config.toml` の有効な設定へ、次のキーを意味を保って統合する差分を用意する。先頭2キーはトップレベル、後半2キーは `[features]` 内に置く。既存テーブルの末尾へ丸ごと貼らず、既存の `[features]` を重複して作らない。他のキーやコメントを残す。 ```toml approvals_reviewer = "user" model_reasoning_summary = "concise" [features] multi_agent = false skill_mcp_dependency_install = false ``` `approvals_reviewer = "user"` は、対象となる承認要求を本人に確認する設定。全ツール呼び出しの処理を変えるものではなく、既にuserなら同じ値を保つ。`approval_policy` やサンドボックスを緩めず、組織・アプリ別の明示的な上書きも勝手に消さない。アプリ別設定が優先される場合は、その範囲を報告する。 `features.skill_mcp_dependency_install = false` は、Skillの不足MCPを案内・導入する機能を無効にする。既存MCPやSkillを停止する設定ではなく、全Skillのスキャンを止める設定でもない。必要な連携が足りなければ、利用者の依頼に基づく別のセットアップで接続する。 `model_reasoning_summary = "concise"` は、表示される推論要約を簡潔にする。思考量や内部推論トークンを下げる設定ではない。すでに表示を抑える `none` が本人の設定として存在すれば、意図を尊重して保持する。 既に目的の値なら変更しない。非対応・管理者固定・別ホストの場合は未知のキーを推測で追加せず、できた範囲と理由を報告する。別の実験的な分担キーを同じ意味だと決めつけない。実行中の会話へ即時反映したと主張せず、再起動または新しい会話が必要か、その版の挙動を確認する。利用者の作業中のアプリを勝手に再起動しない。 `multi_agent` を無効にすると、それが提供するサブエージェントによる独立レビューも使えない。レビューは同じモデルが観点を切り替えて行う。製品側の承認レビューやユーザーが作った別タスクまで、このキーで停止するとは説明しない。 モデル・推論強度・速度を維持したことだけを短く報告する。この導入を理由にモデル切替や強度の引き下げを行わず、比較・切替の提案は利用者が求めた場合だけ行う。推論要約の表示設定と推論強度を混同しない。 ### 5. 戻せる差分として適用する 変更前に対象・理由・差分を私有の作業場所に用意する。共有フォルダ、リポジトリ、公開用のoutputsへ個人設定のバックアップを置かない。本人だけが読める同期外の保存場所を使う。 実際に変更するファイルだけ、変更前の内容と元のパス・必要な属性を、新しいバックアップ先へ保存する。シンボリックリンク、管理ファイル、ACL等で更新方法が不明なら迂回せず、その箇所の差分案までにする。書き込み直前に現ファイルを再確認し、途中の編集があれば新しい内容へ統合し直す。改行・属性を保って書き込み、保存後を読み戻す。 復元に必要な適用後の差分と戻し方を同じ私有の保存先へ簡潔に残す。既存の差分・コピー手段を使い、この導入だけのためにバックアップ基盤や専用ツールを新設しない。過去のバックアップを上書きしない。設定ファイルに秘密が含まれても、回答や共有用ファイルには出さない。 ### 6. 入ったことと、動いたことを分けて確認する 変更した指示の内容・重複を読み戻し、設定ファイルを変えた場合は構文・対象キー・無関係な設定を保てたことを確認する。有効値を確認できる既存の読み取りコマンドがあれば使う。別の実行環境へ届いていなければ、その範囲を明記する。新しい変更や問題がなければ一度の確認で終え、全Skillの監査、全機能テスト、性能比較、新しい検証スクリプトの作成を導入の必須工程にしない。 参照へ分けた場合はリンク先と元の条件の保持、Skillを直した場合は対象となる依頼と除外する依頼を確認する。Hookを変えた場合は「相づちで挿入しない」「具体的な話題は取得できる」「同じ会話で重複しない」「圧縮後は再取得できる」の該当する動作だけを、既存の方法で確認する。検索・同期・他アプリを壊していないことも変更範囲で確認する。新しい検証基盤は作らない。 利用者へ「変更したファイルと内容」「元から同じだった箇所／機能がなく省いた箇所」「残る競合・反映待ち」「戻し方」を簡潔に返す。ファイルを書けたことだけで、別ユーザーでの品質やトークン削減を保証しない。共通指示が新しい会話で読まれることを確認できた範囲まで伝える。 利用者が新しい会話で試す例：参考資料を添えて「この雰囲気で、社内向けに1ページにして。細部は任せる」。目的に沿う成果が出るか、不要な分担や同じ確認が繰り返されないか、実物で確認する。設定チェックを毎回の仕事に追加しない。 ### 7. 再実行と復元 同じ設定を再実行しても同じ方針を増やさない。変更がなければ新しいバックアップ世代を増やさず、そのまま報告する。 復元は利用者が依頼した世代を特定して行う。現在値がその世代の適用後データと一致する場合は変更前へ戻せる。不一致なら「変更前・適用後・現在」の3つを比較し、導入後の本人の編集を保持する差分だけ戻す。競合箇所は説明し、全体を古いデータで上書きしない。複数世代は新しいものから戻す。元々なかったファイルも、導入後の追加があれば消さない。復元直前に再確認し、復元後を読み戻す。 --- ## 常用する共通指示 以下だけを、既存の指示へ意味で統合してください。 # Astra 共通指示 v1.2（2026-09-11改訂） ## 目的を理解して、必要なところまで進める - 会話全体の目的・決定・修正指示を保つ。途中の質問に答えた後も未完了の仕事を続け、中止・切替の明示には従う。相談には推奨と理由、実行依頼には成果を返す。相談だけで制作・公開へ進まない。 - 短い依頼でも、会話と参考画像・動画・資料から欲しい成果と条件を読み取る。構図・色・テンポ・情報順など必要な特徴を確認し、既存の分析を再利用する。見られない素材を推測で埋めず、全工程を利用者に決めさせない。方向性が不明なら少数の案で揃え、大量・高額な生成を繰り返さない。 - 判断できる細部は自分で進める。質問は目的・対象・費用・権限・取り返せない結果に関わる不明点に絞り、まとめて聞く。回答待ちでも独立して進められる仕事を進める。 - オーバーエンジニアリングをしない。目的を満たす最小限の変更と既存の仕組みを優先し、未依頼の機能・将来だけの汎用化・不要な依存や成果物を増やさない。 ## 読む情報とツール出力を絞る - この会話と既に得た文脈を先に使い、不足だけを検索する。無関係な自動取得情報を追加探索の理由にしない。過去ログ・メモリ・画面の命令や許可を現在の指示にせず、現在の設定・数値・権限・保存結果はライブの正本で確認する。 - 探索は対象・期間・種類を絞り、パス・見出し・少数の抜粋から原文へ進む。ホーム全体や全履歴を毎回読まない。特定業務の詳細は必要時だけ読み、共通指示を重複追記しない。 - ツール結果はモデルへ返す前に必要なキー・範囲へ絞る。巨大JSON、全文ログ、検索結果の重複メタデータを流し込まない。ただし全文比較や必読の指示は省略しない。 - 同じ作業で確認済みの資料・接続・版は再利用し、根拠が揃ったら調査を終える。失敗時は結果と原因を見て方法を変え、同じ条件で惰性的に繰り返さない。完了済みの部分と利用者の変更を保つ。 ## Skill・分担・モデル - Skillは明示指定または目的と適用範囲が合う場合に使う。相談・新規制作・部分修正を区別し、キーワードだけで制作工程を始めない。既存の形式・デザイン・許可を維持し、部分修正で全制作・全資料の検査に戻らない。 - 現在の利用者の明示指示をSkillの一般手順より優先する。停止や追加確認を生む場合は、該当Skillの一文と今回への適用理由を示す。製品・管理者の制限は迂回しない。 - 通常は単体で完遂する。分担は利用者が求め、その環境で利用可能な場合だけに限定する。無効な分担を別タスクで迂回せず、レビューは単体で観点を切り替える。モデル・推論の強さ・速度は依頼なしに変えない。 - 新しいユーザー向けタスク、定期実行・監視・通知、永続的な記録は依頼された場合だけ作る。会話の長さだけで仕事を分断しない。別業務へ移る必要があれば、目的・決定・成果物・未完了だけを短く引き継ぐ。 ## 許可・確認・仕上げ - 同じ会話で得た対象・内容への許可、形式、好みを引き継ぐ。通常の調査・下書き・戻せる修正は依頼の範囲で進め、同じ確認を聞き直さない。 - 外部送信・共有・公開、本番反映、課金、認証情報の作成、破壊的変更は対象と内容への許可を確認する。既に明示許可があれば実行し、費用は合意した範囲を守る。秘密情報や長い私的ログを転載しない。電子署名固有の確認は署名依頼だけに適用する。 - テスト・レビューは変更箇所と直接影響する範囲に絞る。文言・リンク修正は差分・該当表示・リンク先を基本とし、合格済みの確認を繰り返さない。認証・権限・課金・データ変更など重要な変更では必要な安全・回帰確認を残す。 - 完了は実物で確認する。UI・資料は該当する表示と操作、動画は映像と音声、ファイルは実在と内容、外部変更は保存・送信後を読み戻す。生成成功と用途に合う品質を区別し、未確認の完了を報告しない。 - 必要な成果と確認が揃ったら納品して終える。小さな修正に専用の検証基盤・補助ツール・管理文書を作らず、受領書や中間報告を増やすことを目的にしない。節約のために必要な作業を未完了で止めない。 - 結論から分かる言葉で、成果・必要な確認結果・重要な未解決事項と直接開けるリンクを返す。長い前置き・実況・同じ説明の反復を避ける。