仕様書更新スキル
REQの実装が完了したタイミングで、以下を更新します。
実行タイミング
- •REQの全フェーズが完了したとき
- •実装完了の報告を受けたとき
- •
/spec-updater REQ-XXXXXXXで明示的に呼び出されたとき
更新対象
1. 仕様書 (docs/specification/features/)
対象機能の仕様書を作成または更新:
- •新規機能: 新しい仕様書ファイルを作成
- •既存機能の拡張: 該当セクションを追加・更新
仕様書の構成
markdown
# 機能名 ## 概要 機能の目的と核心思想 ## 画面 関連するScreen ## キーバインド 操作方法の一覧表 ## データ構造 主要な構造体とフィールド ## 設定(あれば) 設定ファイルと項目 ## 関連REQ 関連する要件ドキュメント
2. REQドキュメント (docs/requirements/active/)
- •フロントマターの
statusをcompletedに変更 - •
completed_atを追加 - •受け入れ基準のチェックボックスをすべて
[x]に更新
3. スキルREADME(必要に応じて)
.claude/skills/README.md に新しいスキルを追記
チェックリスト
更新前に以下を確認:
- • 全フェーズの実装が完了しているか
- • テストがパスしているか
- • PRがマージされているか
- • 将来機能が残っていないか(下記参照)
将来機能の切り出し(必須)
REQに以下のような未実装機能が残っている場合、completedにする前に別REQに切り出すこと:
- •「将来的な拡張」「将来検討」セクション
- •「Phase N(将来)」のような未実装Phase
- •「スコープ外だが将来対応」のような記述
理由: doneディレクトリに移動すると参照されなくなり、要望が埋もれてしまうため。
手順
- •REQ内の将来機能を確認
- •新規REQを作成(例: REQ-0000010)
- •
depends_on: [元のREQ]を設定 - •将来機能の内容を移動
- •
- •元REQから将来機能を削除し、「関連REQ」として参照を追加
- •両方のREQをコミット
- •元REQをcompletedに変更
使用例
code
ユーザー: REQ-0000002の実装が完了しました Claude: /spec-updater を実行して仕様書とREQを更新します
出力
更新完了後、以下を報告:
- •作成/更新したファイル一覧
- •REQのステータス変更内容
- •コミット・PRの作成(必要に応じて)