PromptingCraft Guidance

PromptingCraft.com

ウェブサイト：promptingcraft.com

製品の正式名称は PromptingCraft.com です。0.3.0 以降、スキルとプラグインの識別子は promptingcraft です（以前は promptcraft）。詳しくは移行に関する注意事項をご覧ください。

開発に関する議論を、新しいコーディングエージェントが実行できるプロンプトに変換します。PromptingCraft.com はタスクの契約を維持し、該当する公式ガイダンスを参照して下書きを作成し、一度批評して、必要に応じて修正したうえで、要件と権限が保持されていることを確認します。プロンプトを作成するアシスタントと、それを実行するエージェントは異なる場合があります。対象：Claude Code と OpenAI Codex。Cursor も対象エージェントとしてサポートされています（Cursor での使用をご覧ください）。現在のソースツリーにあるスタンドアロン Skill のバージョンは 0.4.0 です。プラグインパッケージは別個の 0.4.0 アップグレード候補です。公開済みの ChatGPT プラグインは引き続き 0.3.0 であり、候補はその後継として公開も承認もされていません。既存のリモートガイダンス MCP サーバーが報告するバージョンは 0.3.0 で、別個のサービスです。

変更不可の v0.1.0 タグは過去のソースリリースとして維持されます。別個の ChatGPT プラグインに置き換えられるものではありません。このブランチには、未リリースのガイダンス、互換性、パッケージの変更が含まれています。最新の契約忠実度サンプルでは、それ以前に診断結果にばらつきがあったものの、重大な逸脱は 14 件中 0 件でした。これは保証ではありません。ネイティブの Codex 呼び出しは検証済みです。ChatGPT ネイティブでの有効化と、後続工程での優位性は未検証です。開発用 CI アーカイブは v0.1.0 のリリースアセットに代わるものではありません。

元のタスクがすでに適切な場合、PromptingCraft.com は次のように返すことがあります。 「元のプロンプトはすでに適切です。重大な修正は必要ありません。」 元のテキストは維持されますが、変更がなくても契約とソースの確認は必要です。

実用的な引き継ぎの作成を支援しますが、不足しているアクセス権、権限、リポジトリの証拠、後続工程の正確性の保証を補うことはできません。

正式なソース：GitLab。 公開されている GitHub ミラーからも閲覧とインストールが可能です。GitLab CI が正式なものであり、GitHub Actions は有効になっていません。どちらのプラットフォームでも変更を提案できますが、変更は正式な GitLab プロジェクトを通じて統合されます。

公開のお知らせ

PromptingCraft.com はChatGPT プラグインディレクトリで公開されており、オプションのガイダンス MCP は公式 MCP Registryに登録されています。公開済みの両サービスのバージョンは 0.3.0 です。現在のソースツリーにあるスタンドアロン Skill は 0.4.0 です。インストール方法、機能、検証の詳細については公開のお知らせをご覧ください。

使用方法は 2 通りあります

PromptingCraft を単独のエージェントスキルとして使うか、MCP サーバーを接続して、公式の AI 開発者向けガイダンスに構造化された形でアクセスできます。

	単独のエージェントスキル	スキル + MCP サーバー
インストールするもの	skills/promptingcraft/（手順と日付付きのリファレンス）	プラグイン：同じスキルと mcp.json
ホスト	Codex、Claude Code、Cursor（ローカルのスキルフォルダー）	プラグインの MCP サーバーを読み込むホスト。Codex で検証済み
プロンプト作成（要件、下書き、批評、最終版、変更なし）	はい	はい。同じスキルです
公式ガイダンス	厳選された日付付きのリファレンスを同梱。利用可能な場合は、ホスト独自のドキュメント検索または閲覧機能も使用	search_guidance と get_guidance も利用可能。出典と適用可能性を示すレコード
最新性	実行時にホストが公式ページを実際に読む場合のみ最新。それ以外は日付付きのキャッシュとして明示	check_source_freshness が、公式ページと検証済みスナップショットを比較（キャッシュ期間は最長 15 分）
ネットワーク	不要	https://mcp.promptingcraft.com/mcp への HTTPS（固定のカテゴリと ID のみ。詳しくはプライバシーを参照）
ガイダンスの取得に失敗した場合	同梱のリファレンスを使用し、その旨を伝えます	サーバーが利用できなかったことを伝え、その後、ほかの公式ソースまたは同梱のリファレンスを使用します

MCP サーバーは任意です。MCP サーバーが提供するのは根拠であり、決定権ではありません。スキルは引き続き要件を抽出し、下書きを作成して批評し、最終版に仕上げます。また、常にユーザーの要件と権限が優先されます。どちらの方法でも、ドキュメントがリアルタイムであることは保証されません。同梱のリファレンスには取得日が記載され、最新性チェックでわかるのは、検証後にページが変更されたかどうかのみです。promptingcraft_methodology 種別のレコードは、PromptingCraft.com 独自の手法であり、プロバイダーの推奨事項ではありません。サーバーの詳細は mcp/README.md とデータの境界を参照してください。

簡単な例

依頼：「Codex のタスクを書いてください。API エラーの後に保存成功と表示されます。API の形式を維持し、デプロイはしないでください。」

下書き：「保存を修正してテストを実行する。」

批評：下書きでは症状、API の制約、デプロイの境界が失われています。

最終版：

Fix Save so an unsuccessful API response is not reported as success. Preserve
the API shape. Locate the existing save path and verify the requested failure
behavior. Do not deploy.

Optional suggestion: use the existing error-display pattern if one is available.

これは独自に作成した例であり、実行品質の向上を証明するものではありません。具体例と評価プロトコルを参照してください。

ChatGPT で使用する

PromptingCraft.com プラグインにはスキルが含まれ、任意のリモート MCP サーバー（ガイダンスサーバー。アカウントや認証情報は不要）が 1 つ定義されています。ローカルソースを一度ビルドし、実際のリポジトリのルートを登録してから、対応する Codex または ChatGPT Desktop のプラグイン管理機能を使ってインストールしてください。正確な手順はローカルへのインストールと ChatGPT の手順を参照してください。 インストール後、新しいチャットを開始し、@ を使って PromptingCraft.com を明示的に選択するか、**「このタスク用の Codex プロンプトを準備してください。」**と依頼してください。確立された議論の内容を使い、コピー可能な 1 つのコードブロックで最終的な実行用プロンプトを返します。

現在の OpenAI ドキュメントでは Chat でのプラグインがサポートされていますが、ローカルソースとアカウントの利用可否は異なります。Codex CLI へのインストールは、ChatGPT Desktop や通常の Chat での有効化とは別に検証されています。この環境では Computer Use から ChatGPT にアクセスできません。これらのネイティブな確認は、文書化された所有者側のゲートとして残ります。サポート対象のインストール方法に、SKILL.md の繰り返しの貼り付けやアップロードは含まれません。取得できない場合、ソースガイダンスは日付付きまたは利用不可として扱われます。

スタンドアロンのスキルをインストールする

Claude Code でスキルを使用するプロジェクトから、skills CLI を使って、現在の公開 GitHub ソースをインストールします。

DISABLE_TELEMETRY=1 npx -y [email protected] add revanbcn/promptingcraft-skill --skill promptingcraft --agent claude-code --copy --yes

これにより、リポジトリの現在のデフォルトブランチにあるスタンドアロンのスキルが、プロジェクト内の .claude/skills/promptingcraft/ にインストールされます。このブランチにはスキルのバージョン 0.4.0 が含まれています。リポジトリの更新に伴い、内容が変わる場合があります。このコマンドは CLI のテレメトリーを無効にし、CLI の非対話型コピー モードを使用します。インストールによってスキルが有効化されるわけではなく、オプションのリモート MCP サーバーもインストールされません。スキルを使うには、新しい Claude Code セッションを開始し、プロンプト作成の依頼とともに /promptingcraft を呼び出してください。

過去のリリースについては、GitLab v0.1.0 から v0.1.0 のスキルアーカイブと SHA256SUMS をダウンロードしてください。展開する前にチェックサムを検証してください。0.2.0 はまだリリースされていません。クローンすると、現在の候補を取得できます。

git clone https://gitlab.com/revanalex/promptingcraft-skill.git
cd promptingcraft-skill
python3 scripts/install_skill.py --host codex --project-dir /path/to/your/project
# Or, for Claude Code:
python3 scripts/install_skill.py --host claude --project-dir /path/to/your/project
# Or, for Cursor:
python3 scripts/install_skill.py --host cursor --project-dir /path/to/your/project

オプションのインストーラーには Python 3.11 以降が必要です。既存のインストール先がある場合は処理を拒否し、明示的に選択したプロジェクトのスキルディレクトリのみを変更します。代わりに、展開した promptingcraft/ ディレクトリを、参照ファイルとライセンスも含めて、自分で .agents/skills/（Codex）、.claude/skills/（Claude Code）、または .cursor/skills/（Cursor。Cursor は .agents/skills/ も読み込みます）にコピーすることもできます。 検出情報が更新されていない場合は、ホストを再起動してください。Codex では $promptingcraft を、Claude Code では /promptingcraft を呼び出してから、必要なプロンプトを説明してください。 このスキルは開発タスクを実行しません。

Cursor での使用

Cursor は、プロジェクト内の .cursor/skills/ または .agents/skills/ と、ユーザー用の ~/.cursor/skills/ から Agent Skills を読み込みます。プラグインのルート（Agent Plugins 1.0.0 スキーマを使用する plugin.json と skills/promptingcraft/）は、Cursor がドキュメントで定めている Agent Plugins 形式に準拠しています。ただし、Cursor Marketplace への提出や審査は受けていません。

実行環境が Cursor の場合、PromptingCraft.com は Cursor の補足資料を読み込みます。Auto では基盤となるモデルを不明として扱うため、選択したモデルが特定されていない限り、Claude、GPT、Composer 向けのプロンプト作成ルールは適用されません。

Cursor CLI での測定結果（Cursor の起動評価）では、デフォルトの Auto 設定（Composer 2.5 Fast と報告）でスキルは利用可能でしたが、自動では有効化されませんでした（プロンプトの依頼 0/30）。**「このタスク用の Cursor プロンプトを作成するために promptingcraft スキルを使ってください」**のようにスキル名を指定すると、2/2 回読み込まれました（0.2.0 の識別子で測定し、promptingcraft でも再測定）。エディターでは / メニューから選択することもできます。有効化されるかどうかは選択したモデルによって異なります。Cursor エディターでのプラグイン読み込みはテストされていません。

プラグインパッケージ

プラグイン ZIP には、Agent Plugins 1.0.0 を使用するルートの plugin.json、skills/promptingcraft/ ツリー 1 つ、assets/ 以下のリスティング用アイコン／ロゴ、Claude Code 互換性マニフェスト、およびオプションのガイダンス MCP サーバーを宣言するルートの mcp.json が含まれます。フックや認証情報は宣言されていません。 ChatGPT のリスティングメタデータ（表示名、説明、ウェブサイト、サポート、プライバシーと利用規約の URL、ブランドカラー、アイコン）はバリデーターでチェックされます。 既存の 0.3.0 プラグインは公開済みです。この 0.4.0 候補は審査に提出されていません。Claude Code では、セッションのみで読み込むには次のようにします。

claude --plugin-dir /path/to/extracted/promptingcraft-plugin
# In that session: /promptingcraft:promptingcraft

リポジトリには、dondego-local 用の .agents/plugins/marketplace.json がすでに含まれています。登録する前に、実際のプラグインディレクトリを準備してください。

python3 scripts/prepare_marketplace.py
python3 scripts/validate.py --marketplace

生成された dist/promptingcraft-plugin/ は、既存の再現可能なアーカイブビルダーを使って、正規のスキルから作成されます。これはスナップショットであり、別個に保守されるスキルではありません。カタログは、リポジトリのルートを基準にパスを解決します。インストール、更新、削除を参照してください。

検証と最新性

python3 -m unittest discover -s tests -v
python3 scripts/validate.py
python3 scripts/package.py --output dist
python3 scripts/prepare_marketplace.py
python3 scripts/validate.py --marketplace
# Optional live maintenance, kept separate from merge checks:
python3 scripts/freshness.py --output /tmp/promptingcraft-freshness --write-baseline

通常のチェックは決定的で、オフラインで実行され、合成ドキュメントを使用します。ライブソースのチェックでは、利用可能な正規化済みコンテンツのハッシュを比較し、提供されている場合は HTTP バリデーターを使用して、公式インデックスから候補リンクを検出します。変更あり、変更なし、新規、欠落／利用不可、部分的／エラーの状態を報告します。ガイダンスが正しいことを証明するものでも、スキルを自動的に変更するものでもありません。取得時刻は公開時刻ではありません。キャッシュと生のモデルのトレースは追跡対象コンテンツの外に保管され、レポートにはプロバイダーのドキュメント全体ではなくメタデータが含まれます。

最新性の運用とスケジュールのゲート、 検証済みのソースに関する判断、実際の検証、 範囲を限定したロードマップを参照してください。ホストのネットワーク機能が許可する場合、スキルの使用時にソースのガイダンスを再検証します。オフラインのメモは最新情報ではありません。

対象範囲とライセンス

オリジナルコンテンツは MIT ライセンスです。OpenAI／Anthropic との公式な提携や推奨はありません。v0.1 および 0.2.0 候補版には、ホスト型アプリ、テレメトリー、サインアップ、モデルルーター、API 課金、マーケットプレイスへの提出、デプロイ、自動的な指示の書き換えはありません。 LICENSE、CONTRIBUTING、SECURITY、 CHANGELOGを参照してください。

dondego.com チームが開発しました。