CodeAppsDevelopmentStandard: Skill for Claude Code

仕様書作成スキル（一次情報 → 要件定義書）

office ドキュメント（PDF / PowerPoint / Excel / Word など）は anthropics/skills で読み取り、
画像ファイル（PNG/JPG 等）は agent-ocr で OCR する。

フォルダ構造

spec/                          ← スキル専用ディレクトリ
├── input/                     # 一次資料。クイックスタートではルートの業務資料を安全に移動・整理
├── output/                    # 全出力はここに入る（ユーザーが参照）
│   ├── staging/               # ファイル単位の中間 markdown
│   └── docs/                  # 統合要件定義書 5 点
│       ├── index.md           # ドキュメント一覧・開発利用フロー
│       ├── business-requirements.md
│       ├── functional-requirements.md
│       ├── design-requirements.md
│       └── test-requirements.md
└── .cache/                    # システム内部用（ユーザーは触らない）
    ├── conversion-checklist.json
    ├── pending_ocr.json
    └── pending_skills.json

最初の依頼を簡単にする

このスキルは 引数なしでも開始できる。

• 既定入力: spec/input/
• 既定 staging 出力: spec/output/staging/
• 既定 docs 出力: spec/output/docs/
• 既定 checklist: spec/.cache/conversion-checklist.json
• --input / --staging / --docs（互換: --output）/ --checklist を指定した場合はそのパスを優先する
• spec/input/ に変換対象が見つからない場合、scripts/convert_documents.py はワークスペース・フォルダ全体をスキャンし、変換候補になりうるファイルがないか確認する。候補が見つかった場合は一覧を提示するので、spec/input/ へ移動するか --input で対象パスを指定する
• 通常は元資料をその場所で読み、--input で指定する。クイックスタートの継続が承認された場合は、 下記の手順でルート直下の業務資料を spec/input/ へ整理する。その他の移動・削除は利用者の明示依頼が必要。

クイックスタートから呼ばれた場合

standard/references/quickstart.md の資料探索結果を引き継いで実行する。 .github に同梱された標準・サンプル、依存パッケージ、生成物、一時 clone、認証ファイルは業務資料ではない。 認証後の要望確認への継続回答を引き継ぎ、ルート直下の業務資料を spec/input/ へ移動・整理する。 エージェントが対象を選び、scripts/organize_input.py --workspace <workspace> --file "<document>" で計画し、 同じ引数に --apply を付けて実行する。複数ファイルは --file を繰り返す。 全件を事前検証し、同名ファイル・symlink・ルート外の指定・運用文書（README / AGENTS / LICENSE 等）を拒否する。 内容を照合してから元の場所のファイルを移し、失敗時は原本を保持してエラーを報告する。移動先・元の場所を記録する。 サブフォルダーの資料は元の場所を --input で参照してよい。原本の内容と承認済み仕様は保護する。 変換・統合後は architecture・テンプレート選定・開発環境へのフル構成デプロイ・実動作検証まで継続する。 業務資料から抽出した事実を推測で書き換えず、業界知識による補完は別の「仮説・推奨」として記録する。 資料なしなら空の変換結果で完了とせず、ワークスペース名から Step 0 で提案・選択された案を具体化し、 architecture の提案先行モードへ進む。白紙の業務ヒアリングは始めない。 既知事項や通常の実装判断で AskUserQuestion を繰り返さない。資料から分かることを自分で調べ、 本人の判断が不可欠な不足事項だけを確認する。