メインコンテンツまでスキップ

unknowns

依頼の中で、調べれば分かることと人間が決めることが混ざっているときに使います。作業を始める前に未知を分類し、必要な確認方法を選びます。

渡す情報​

目的、既知の仕様、未決定事項、参照できる資料、人間が判断したい点を渡します。

依頼例​

unknownsを使って、依頼一覧画面を作る前の未知を整理してください。Reactと既存認証の利用は決定済みです。表示項目と完了済み依頼の扱いが未決定です。必要なスキルと確認順を示してください。

進め方​

  1. 既知の既知、既知の未知、無自覚の既知、無自覚の未知に分けます。
  2. 作業のリスクを分類し、必要な子スキルと実行順を選びます。
  3. 最低限の成果物と、人間の判断/AIの探索の範囲を示します。

成果物の例​

今回の実要件とサイト設定にunknownsを適用した出力です。

到達点:未知の分類と次のスキルの選定。

移行時の確認:既存の実行記録を移行しました。本文の一致は確認しましたが、過去の実行時の同梱資料全体は特定できていません。

このハッシュは移行時の変更検出用の基準です。同梱資料全体をこの版で再実行した証拠ではありません。

実行した依頼​

docsの全スキルの成果物例を実行結果へ置き換える修正について、未知を分類し、必要な子スキルと確認順を整理してください。

実出力の抜粋​

以下は保存した原本の冒頭です。全文は原本から取得できます。

# Unknowns Management

対象はIssue #57の実成果物展示への修正。ユーザーの「docsのすべてのスキルの説明に対する成果物の例」を入力として、現在のdocsとサイト設定を確認した。

## 1. 未知の分類

- 既知の既知: Docusaurusを採用し、23スキルの例を実行結果へ置き換える。Markdownの説明と原本ダウンロードが必要。
- 既知の未知: サンプルPR・IssueをGitHubへ実際に作成する範囲は回答待ち。外部投稿まで完了した実例にはできない。
- 無自覚の既知: 読者が画面を見て判断する画像の大きさや入力・成果物の順序。実ページを提示して確認する。
- 無自覚の未知: Markdown原本をdocsに置くと文書として索引化される可能性。ダウンロードリンクがSPAのページ移動として処理される可能性。

## 2. 作業リスク

- 分類: 中。
- 理由: 公開ファイルとドキュメントの扱いを変え、全スキルの例に影響する。GitHubの作成操作には別の許可範囲がある。

成果物を取得する​

確認した結果​

  • SKILL.mdを読み、今回の実要件と参照対象へ適用して出力を保存。内容の人間確認は未実施。

確認するポイント​

未知の分類が具体的な作業に結びついているか、人間の判断を推測で置き換えていないかを確認します。全スキルを毎回使う必要はありません。

関連するスキル​

正本を読む​

詳細な手順と制約はunknownsのSKILL.mdを参照してください。