qiaomu-goal-meta-skill

Qiaomu 目標メタスキル

曖昧なタスクを、Codex が継続して実行でき、検証でき、いつ停止し、いつ一時停止すべきかを把握できる /goal 指示に絞り込みます。

Copyright (c) 向阳乔木 X: https://x.com/vista8 GitHub: https://github.com/joeseesun/

動作モード

本番環境向けの軽量なメタスキルとして動作します。

デフォルトの前提：

• ユーザーが求めているのは一般的なプロンプトではなく、そのまま貼り付けられる Codex /goal コマンドです。
• 実行可能なスラッシュコマンドは /goal のままにします。ユーザーの環境でそのエイリアスが明示的に文書化されていない限り、コマンドとして /目標 を出力しないでください。
• 最初のゴールブロックには、未完成のテンプレートではなく、最適な推奨実行版を記載します。ユーザーは最初の草案をそのままコピーすることがよくあります。
• 中国語ユーザーには、コマンドの接頭辞 /goal を維持しつつ、デフォルトで中国語の内容とフィールド名を出力します。
• 中国語ユーザーには、ユーザーが一つの言語だけを求めている場合を除き、推荐执行版（中文，可直接复制） と Goal Draft (English-compatible) の両方を含めます。
• タスクがまだ曖昧でもリスクが低い場合は、最も保守的なデフォルトを選んで進めます。回答によってコスト、リスク、責任の所在、または製品の方向性が変わる場合に限り、質問します。
• 分野に不慣れな場合や専門性が高い場合は、ドメイン固有のルールを作り上げるのではなく、実装前にエージェントが信頼できるプロジェクト、ドキュメント、実行時の証拠を調査する、調査優先のゴールを作成します。
• 不足している情報のリスクが低い場合は、前提を明示して進めます。
• ユーザーが明示的に依頼しない限り、ゴールで説明されている作業を開始しないでください。このスキルはゴールの指示を作成します。
• 曖昧な確信を示す表現よりも、具体的な検証コマンドと成果物を優先します。
• 広範な許可よりも、書き込み範囲を限定し、禁止パスを明示することを優先します。
• Stop when と Pause if は、同一の完了／ブロック条件の一部として扱います。

ワークフロー

1. タスクを作業ではなく成果として言い換えます。
2. references/default-goal-strategy.md を使って、タスクを分類します：既知か未知かのドメイン、低リスクか高リスクか、新規作業か既存プロジェクトか。
3. リスクが低く未知である項目には最適なデフォルトを選び、その理由を一文で記載します。
4. ゴールの契約に関して不足している情報を特定します：
   • 成功基準
   • 検証コマンド、成果物、または証拠
   • 変更してはならない制約
   • 書き込みが許可された範囲と禁止パス
   • 反復の方針
   • 完了を示す証拠
   • ブロック時の停止条件、人による判断、または予算上限
5. タスクの指定が不十分な場合は、デフォルト付きの番号付き選択肢を優先します。references/interview-checklist.md を使用します。
6. 中国語を優先するユーザーには、まず中国語の推奨実行ゴールを提示し、次に同じ意味を保ち、英語のフィールドラベルを使用した英語互換のミラーを提示します。
7. references/goal-command-playbook.md に照らしてコマンドを確認します。
8. ファイル形式の成果物については、ゴールを完了とする前に python3 scripts/lint_goal_command.py <file> を実行します。

出力仕様

十分な情報が得られたら、最適な推奨コマンドを最初に出力します。実際の出力にプレースホルダーを残さないでください。

/goal Create a first-version local MVP for the requested task, inspect project-provided commands before changing code, implement the core user-visible workflow, and keep unrelated systems unchanged.
Verification: run the smallest project-provided checks, start the local app or relevant runtime, complete the core workflow once, and capture logs/screenshots or command output as evidence.
Constraints: do not add accounts, paid services, production changes, destructive operations, or unrelated features unless requested.
Boundaries: write only inside the new project directory or the directly related existing project files.
Iteration policy: implement one focused workflow at a time, rerun checks after meaningful changes, inspect logs before retrying, and make at most 3 focused improvement rounds before reporting remaining risks.
Stop when: the core workflow is proven by runtime evidence and checks pass or missing checks are explicitly reported.
Pause if: credentials, payments, production data, destructive changes, legal/medical/financial decisions, copyrighted assets, or unclear ownership is required.

中国語を優先するユーザーには、次の同等の形式を推奨します：

/goal 基于用户需求创建第一版本地 MVP，先读取项目已有命令和约束，实现核心用户可见流程，并避免改动无关系统。
验证：运行项目提供的最小相关检查，启动本地应用或对应运行环境，完整走通一次核心流程，并用日志、截图或命令输出作为证据。
约束：不加入账号、付费服务、生产变更、破坏性操作或无关功能，除非用户明确要求。
边界：只写入新项目目录，或只修改现有项目中与该功能直接相关的文件。
迭代策略：一次实现一个聚焦工作流，每次有意义改动后重跑检查，重试前先读日志，最多做 3 轮聚焦改进后报告剩余风险。
完成条件：核心流程有运行证据证明可用，检查通过或明确说明缺少配置。
暂停条件：需要凭证、付费、生产数据、破坏性操作、法律/医疗/金融判断、版权素材或所有权不清时暂停。

タスクが曖昧な場合は、次を出力します：

1. 推荐执行版（中文，可直接复制）：最適なデフォルトの /goal。
2. 默认选择理由：簡潔な理由を一文で記載します。
3. 可选调整：推奨デフォルトと短い選択肢ラベルを付けた番号付き選択肢。
4. 你可以直接回复：按默认 や 1B 2A 3C などの例。
5. Goal Draft (English-compatible)：英語のフィールドラベルを使った、内容に忠実な英語互換のミラー。

ユーザーが英語で書いた場合は、中国語も求められない限り、英語互換の草案だけを出力します。

ユーザーから説明を求められない限り、一般的な長文のガイダンスは出力しないでください。

品質基準

良い目標の条件：

• 具体的な成果が1つ定まっている
• 正確なチェック項目または根拠を明記している
• 無関係なファイル、ユーザーデータ、シークレット、デフォルトブランチを保護している
• 書き込み可能な範囲を定義している
• 失敗後にエージェントがどのように反復するかを示している
• 完了が証明された時点で停止する条件を示している
• 人間の判断、認証情報、アカウントの状態、予算、または繰り返し発生する阻害要因が必要な場合に一時停止する条件を示している

次のような目標は却下するか、修正してください：

• make it better、finish this、fix bugs としか書かれていない
• 検証方法がない
• 理由もなく、エージェントがマシン全体またはリポジトリ全体を編集できる
• 新しい根拠もないまま、繰り返し再試行するよう求めている
• 外部認証、シークレット、支払い、破壊的な操作、または曖昧な製品上の判断に対する一時停止条件がない
• ユーザー向けの実行可能なドラフトに、[Outcome] のようなプレースホルダーが残っている
• 高级、有质感、professional のような曖昧な言葉を、スクリーンショット、実行時チェック、レビュー基準、反復ルールに落とし込まず、検証方法として扱っている

参考ファイル

• references/goal-command-playbook.md：/goal の基本テンプレート、使用するタイミング、例、アンチパターン。
• references/default-goal-strategy.md：ユーザーが詳細を指定しない場合のデフォルト、未知の分野の調査、リスク分類、直接コピーできる出力のルール。
• references/interview-checklist.md：曖昧なタスクを明確な目標にするための質問集。
• scripts/lint_goal_command.py：必須の /goal ラベルと未解決のプレースホルダーを確認する軽量チェッカー。