Decision record
Decision
Keep original inputs unchanged
Reason
Allow later source reconciliation
Open questions
Where should revisions be stored?
実際の出力・確認記録あり
実稼働サンプル · Markdown
# Decision record ## Decision Keep original inputs unchanged ## Reason Allow later source reconciliation ## Open questions Where should revisions be stored?
自作Skillに対して2件のテストケース（失敗基準付き）を作成して実行してください。
実際の成果と確認記録あり・検証範囲は証拠を参照
- 双方のタスク出力と判定理由が記録として保存されている
- 境界系テストで適切な拒否や確認の挙動が確認できた
現在1件の実稼働サンプルを公開しています。すべての入力に対する結果を保証するものではありません。実利用時は事実関係をご確認ください。
テスト検証基準を見る
出力そのままの状態で掲載（閲覧用レイアウトのみ調整）
サンプルをダウンロード
動作環境
Codex
ご自身のAgentで実行され、モデル利用料は各提供事業者に請求されます
検証環境：
Agent・モデル料金は提供元によります。追加サービスと必要条件は完全パッケージを参照。
Node.js 18+
Node.js 18+
メインクエストのどのステージで使うか
SkillはAIの武器。メインクエストと連動して実践・習得へ進めましょう。
この成果から次へ進む: マルチAgent協調ワークフロー →
✓ こんな方におすすめ
- 実践しながら学ぶAI初心者
- 対応するレッスンから開始します。閲覧だけで課題完了とは記録しません。
⊗ おすすめできない用途
- 指定タスクを超える無人操作や未承認のアカウントアクセス
✦ 手に入るもの
- テストケースを定義し、Skillの品質を客観的に証明する
- 双方のタスク出力と判定理由が記録として保存されている
- 境界系テストで適切な拒否や確認の挙動が確認できた
提供物：完全な SKILL.md 仕様書 + 検証サンプル。各自のAI Agent上で実行します。
どう始める？
Skillとは、AIにタスクを教えるための作業規則です。
1
素材を渡す
自作Skillに対して2件のテストケース（失敗基準付き）を作成して実行してください。
2
Agentがルールに従って実行
テストケースを定義し、Skillの品質を客観的に証明する
3
保存された結果を開いて確認
双方のタスク出力と判定理由が記録として保存されている
Agentへ送信するプロンプト
skill-qa を使ってこの課題を手伝ってください。不足する素材を確認し、実際のツールで結果を保存して、課題の基準と照合してください。
ここから利用を開始
zip にはルール・リファレンス・スクリプト・実出力・デモが入っています。プロンプト一枚ではありません。
- CodexまたはClaude Codeを開き、導入プロンプトを貼り付けます。
- Agentにルール全文を読み込ませ、認識されたことを確認します。
- 上記のプロンプト例をコピーし、手元のメモに差し替えて実行します。
手動導入 · SKILL.md全文を確認（50行）
Codex：~/.agents/skills/skill-qa/SKILL.md
Claude Code：~/.claude/skills/skill-qa/SKILL.md
---
name: skill-qa
description: Design and actually execute small behavioral self-tests for an existing Skill, including a different normal input and a missing-input boundary, with saved results and evidence-based verdicts. Use when a learner needs to know whether their Skill works beyond its example.
---
# Test what your Skill actually does
Main quest 3-4. A checklist describing tests is not a completed test run.
## Define observable behavior
Read the installed Skill's actual promises and choose a realistic user request.
Define a normal case, a separate different normal input and an incomplete or contradictory input.
Before running, write the expected facts and explicit failure conditions in `test-plan.md`.
Do not use a frozen expected answer as the model's prompt.
Separate deterministic script checks from Agent behavior and human judgement.
Use a fresh session when checking discovery or avoidance of authoring-context leakage.
## Run and retain evidence
Use the actual Skill and permitted tools to complete each test.
Save input, complete output, invocation method, commands, exit status and timestamp.
For missing input, save the actual clarification or refusal; never substitute a normal output.
Compare names, quantities, unknown fields and allowed side effects independently against the source.
Record PASS, FAIL or UNKNOWN with a concrete reason.
Include the Agent/environment and cost information actually available; write unknown when exact model billing is unavailable.
Keep public practice inputs separate from private user material.
## Fix demonstrated failures
Change the narrow instruction or helper responsible for the observed failure.
Repeat affected tests and retain the failed observation as history.
Do not inflate a pass rate by dropping failed or difficult cases.
Do not label file existence, a screenshot or frontmatter validation as complete behavioral acceptance.
Read `references/verdict.md` for a short evidence record.
## Self-tests and failure criteria
1. Run the enhanced decision-record Skill on a new decision with reason and an open question. Reconcile all facts and run its checker.
2. Use a different decision without a reason. The output must preserve Not supplied rather than invent a benefit.
3. Provide only a reason with no decision. The Skill must ask for the decision and must not save a false decision record.
4. Provide a broken result with no Decision section. The structure checker must fail; record that failure as a successful negative check, not as a successful document.
Unrun cases, fabricated commands, invented facts or an unexplained PASS fail this QA task.
## Continue
Return `/path/skill-qa/`. Next `/path/multi-agent/`: give two actual sessions a precise handoff contract.
Original free workflow. Personal and commercial use allowed; no complete-package resale.
始める前によくあるご質問 (FAQ)
購入前に疑問を解消し、スムーズに使いこなしましょう。
始め方は？
完全なZIPを取得し、導入用プロンプトをAgentに渡します。スクリプトと参照ファイルを一緒に保持してください。モデル料金は別です。
基礎クエストは無料ですか？
はい。基礎メインクエストは無料です。発展Studio商品の個別料金は別に定められています。