GPT-6 Astraが頻繁に止まる？AGENTS.mdとSkillsを整理する
Astraの不要な停止を調べる実践的な監査です。読み込まれた指示を確認し、競合する承認条件を外し、Skillsを絞って同じ課題を比較します。
目次
GPT-6 AstraがGPT-5.6 Solより多く質問する場合、まず回答が結果を実質的に変えるかを判断します。変えるなら確認は妥当です。一方、fileを読む前に許可を求める、承認済みの変更を行わずplanだけ返す、文書変更後に全test suiteを走らせる場合、読み込まれたAGENTS.md、nested override、広すぎるSkillが原因かもしれません。
OpenAIは、Astraが結果に影響する判断をより確認し、長い指示にも正確に従うと説明しています。そのため曖昧または競合するruleの影響が強くなります。実際のchainを確認し、各levelに恒久的なruleだけを残し、同じ限定taskを再実行します。
2026年9月6日時点でBetterTokenはgpt-6-astraをGPT groupに掲載し、Responses APIのcustom providerとして公式Codexへ接続できます。
BetterToken経由でGPT-6 AstraをCodexに接続する
現行設定はBetterToken Codexガイドにあります。BetterTokenが提供するのは接続であり、Codexが読む指示やAstraの質問はconfigとtaskで決まります。
モデルが実際に見る全instructionを探す
公式AGENTS.mdルールによると、Codexはsession開始時に次を読みます。
- global
AGENTS.override.md、なければglobalAGENTS.md。 - project rootからCWDまで各directoryで最大一file。
AGENTS.override.md、AGENTS.md、project_doc_fallback_filenamesの順に最初のnon-empty fileを選ぶ。 - CWDに近いruleほどchainの後に入り、前のruleを上書きできる。
空fileは無視され、project instructions全体にはproject_doc_max_bytes、default 32 KiBの上限があります。長いroot fileが必要なspecific ruleを押し出す場合があります。同じdirectoryから新sessionを開始します。
codex --ask-for-approval never "List the instruction sources you loaded."project_doc_fallback_filenamesと選ばれ得るfallback fileをすべて確認します。active Skillsと選択されたSkillのsourceも記録してください。Codexはrepository、user、admin、system locationsからSkillを発見できます。変更前にbaselineを保存します。
各ruleを四つの質問で分類する
| 項目 | 質問 |
|---|---|
| Scope | 全repository、project、特定directoryのどれか |
| Trigger | どの具体的taskで有効になるか |
| Action | Codexは何を行うか |
| Stop | userの回答まで停止する必要があるか |
明確なtriggerがないAlways ask before making changes、Use every relevant skill、Run all tests before finishing、Do not make assumptionsは不要な停止を生みます。不可逆削除、公開、有料操作、非互換architecture、missing secretのように結果や権限が変わるときだけstop conditionを残します。委任済みtaskでのfile読取、scoped edit、target testに通常は追加承認が不要です。
AGENTS.mdは短く恒久的にする
問題のあるrootは全場面を規定します。
AGENTS.md
- Always ask the user before changing any file.
- Always create a detailed plan and wait for approval.
- Use all available skills that may be relevant.
- Run the full test suite after every change.
- Never make assumptions.
- Never stop until everything in the repository is fixed.より良いbaseは成果と境界を定めます。
AGENTS.md
## Working agreement
- Complete the user's requested outcome with the smallest correct change.
- Treat the user's current instruction as higher priority than reusable workflow guidance.
- Make routine, reversible assumptions when they do not change the requested outcome; state material assumptions.
- Ask only when a missing choice would materially change the result or authorization.
- Preserve unrelated work and do not expand scope to optional cleanup.
- Run checks proportionate to the changed behavior; broaden only when evidence justifies it.
- Stop after the requested result and relevant checks are complete.恒久的なcommands、commit conventions、禁止事項だけを追加します。service固有ruleはそのdirectory近くへ置きます。一時的なAGENTS.override.mdは同じdirectoryのAGENTS.mdを補完せず置き換えます。必要ruleをoverrideに移すか、狭いscopeにはnested AGENTS.mdを使い、実験後にoverrideを削除します。
内容を正しい場所へ分ける
| 内容 | 場所 |
|---|---|
| 恒久的なproject rule | root AGENTS.md |
| directoryまたはservice rule | nested AGENTS.md / AGENTS.override.md |
| 明確なtriggerを持つ稀なworkflow | narrow Skill |
| parsing、formatting、schema validation | script / hook |
| 長いreferenceとexample | 選択Skillのreferences/ |
Codex Skillsはprogressive disclosureを使い、最初にnameとdescription、選択後に完全なSKILL.mdを読みます。各Skillを一jobにし、description冒頭にtriggerと境界を置きます。
---
name: release-preview
description: >-
Use only when the user asks to build a local release preview; do not publish,
deploy, push, or change production state.
---SKILL.mdにはinputs、outputs、imperative steps、stop conditionsを残し、大きな例はreferences、deterministic actionsはscriptsへ移します。発火すべき一promptと発火しない近い二promptsでdescriptionを試します。同じrequestで二Skillsが動くならtriggerを分けるか重複を統合します。
Autonomyとverificationを明記する
Astraガイドは、暗黙の依頼を完成まで進め、現在のuser instructionを優先し、実質的な影響がある場合だけ質問し、riskに応じてchecksを選ぶよう推奨します。同じblockを全Skillに複製しません。Subagentsは独立subtasks、十分な作業量、明確な統合方法がある場合だけ使い、「常に複数agents」というruleを避けます。
同じfixtureを再実行する
Update one configuration field in docs/setup.md, preserve all unrelated files,
run the Markdown link check for that file, and report the changed path.同じdirectory、model、permissions、stateでbefore/afterを実行します。最初のedit前の質問、user inputの必要性、loaded filesとSkills、実行checks、unrelated changesを記録します。改善は質問ゼロではありません。重大な判断では聞き、routine decisionは進め、十分に検証し、scopeを守ることが目的です。
本稿ではuser repository上のcontrolled replayを実行していないため、質問数の固定削減を保証しません。この方法ならmodel behaviorと特定instructionを観測可能な形で分けられます。
