reference
既存コード、画面、仕様、過去の成果物に合わせたいときに使います。見た目のコピーだけでなく、命名や責務、動作の意図を取り出します。
渡す情報
参照対象の場所、今回の対象、合わせたい観点を渡します。
依頼例
referenceを使って、既存の顧客一覧を参考に依頼一覧の設計ルールを整理してください。検索、空状態、エラー表示を合わせたいです。顧客固有の表示項目は引き継ぎません。
進め方
- 参照対象を実際に読み、仕様や設計意図を抽出します。
- 合わせるべき点と、今回合わせなくてよい点を分けます。
- 参照対象との差分と適用方針を示します。
成果物の例
指定されたruleの設定と、contextの実ファイルを参照した分析です。
到達点:参照分析。
移行時の確認:既存の実行記録を移行しました。本文の一致は確認しましたが、過去の実行時の同梱資料全体は特定できていません。
このハッシュは移行時の変更検出用の基準です。同梱資料全体をこの版で再実行した証拠ではありません。
実行した依頼
ruleのdocusaurus.config.tsとcontextの設定・検索・utilsカタログを実際に読み、実成果物展示へ合わせるべき点と差分を抽出してください。
実出力の抜粋
以下は保存した原本の冒頭です。全文は原本から取得できます。
# Reference Analysis
## 1. 参照対象
- ruleリポジトリのdocusaurus.config.tsを実際に読んだ。
- contextのdocusaurus.config.ts、plugins/site-search/index.js、utils/skills/README.mdを実際に読んだ。
- Docusaurus 3.10.2の公式Assets資料を確認した。https://docusaurus.io/docs/markdown-features/assets
## 2. 抽出した意図
- ruleはmarkdown.formatをmdにし、Markdownリンクと画像の欠落をビルドで検出する。
- ruleは日本語を既定ロケールとし、独自site-searchプラグインを使う。
- contextの検索は公開ドキュメントの本文を読んで索引を作る。原本を文書に含めると索引にも入る。
- contextの共通スキルは6分類に所属し、SKILL.mdが正本、READMEがカタログである。
## 3. 合わせるべき点
成果物を取得する
確認した結果
- SKILL.mdを読み、今回の実要件と参照対象へ適用して出力を保存。内容の人間確認は未実施。
確認するポイント
根拠のファイルや箇所を開けるか、参照のどの部分を採用したかが明確かを確認します。
関連するスキル
- plan:適用方針を計画にする。
正本を読む
詳細な手順と制約はreferenceのSKILL.mdを参照してください。