scan-new-specs について
マージ済み仕様からドキュメント作業を探す、非推奨のスキルです。実行やスケジュール設定はせず、リリース起点の `missing_docs` を使います。`write-feature-docs` は対話形式で引き続き利用できます。
主な機能
- 01廃止済みのため実行・予約不可
- 02`missing_docs` に置き換え
- 03対話型 `write-feature-docs` は引き続き利用可能
活用シーン
- 01`missing_docs` の drift-watch モードでドキュメント不足を確認
- 02`write-feature-docs` で機能ドキュメントを対話的に作成
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/インストール後、Claude Code で/scan-new-specsを入力して読み込まれたか確認します。
詳細
scan-new-specs（非推奨）
2026-08-20 に廃止されました。このスキルを実行したり、スケジュールに設定したりしないでください。
スケジュール設定されたエージェント（0ITuF9vNJ1RiO00Szlm1fW）は一時停止中で、今後も一時停止のままです。
廃止の理由
このスキルは仕様のマージ時に実行されていましたが、これは機能のリリース前です。この設計上の選択から、次の2つの問題が発生しました。
- 未リリースの作業や、場合によっては中止された作業のドキュメントを作成していました。 仕様のマージは機能のリリースを意味しません。エージェントにはユーザーが実際に受け取ったものを示す証拠がなかったため、まだ実装されていない、実装内容が異なっていた、あるいは結局実装されなかった動作についてページが書かれていました。
- すべての仕様をドキュメント作成タスクとして扱っていました。 変更にドキュメントが必要かどうかを確認することなく、純粋な UI の変更、小規模で直感的な追加、裏側の作業まで、すべてがドラフト PR になり、ドキュメントリポジトリには、レビューが追いつかないほど未精査のコンテンツ負債が蓄積しました。
後継となるもの
warpdotdev/docs の missing_docs スキルをドリフト監視モードで実行します。重要な2つの点で異なります。
- リリースをトリガーとします。
scripts/check_new_release.pyによって、新しい安定版リリースがある場合にのみ各実行が行われるため、パイプラインは計画ではなく、実際にリリースされたものを確認します。日次のスケジュールで、リリースごとの処理を実行します。 - ドキュメント化する価値があるかを判定します。 何かをドラフトする前に、すべての候補を
.agents/references/docs-worthiness-criteria.mdに照らして評価します。既定ではドキュメントを作成せず、具体的な証拠の提示を必須とします。不採用を含む判定はreferences/changelog_decisions.mdに記録されるため、同じ内容を再び議論する必要はありません。
ドキュメント化する価値が本当にある内容は、リリース後にここで再び取り上げられます。
このスキルを実行しようとしていた場合
- ドキュメントの不足を探していますか？
warpdotdev/docsリポジトリで、ドリフト監視モードのmissing_docsを実行してください。 - 機能のドキュメントを作成したいエンジニアですか？
write-feature-docsを直接、対話形式で実行してください。引き続き利用でき、仕様の調査と概要の確認も順を追って進められます。ヘッドレスでは実行されなくなりました。 - スケジュール設定されたドキュメント作成エージェントを設定していますか？ このスキルではなく、
missing_docsを使用してください。このスキルをスケジュールに設定すると、廃止された理由そのものである過剰なドキュメント作成が再発します。
関連スキル
missing_docs（warpdotdev/docs内）— リリースをトリガーとし、ドキュメント化する価値の判定を行う後継スキルwrite-feature-docs— エンジニニアが直接、対話形式で使用する場合は引き続きサポートされています
コメント
Markdown 対応