AgentSkillsCN

spec-updater

在实现完成后,同步更新需求文档与规格说明书。

SKILL.md
--- frontmatter
name: spec-updater
description: 実装完了時に仕様書とREQを更新する

仕様書更新スキル

REQの実装が完了したタイミングで、以下を更新します。

実行タイミング

  • REQの全フェーズが完了したとき
  • 実装完了の報告を受けたとき
  • /spec-updater REQ-XXXXXXX で明示的に呼び出されたとき

更新対象

1. 仕様書 (docs/specification/features/)

対象機能の仕様書を作成または更新:

  • 新規機能: 新しい仕様書ファイルを作成
  • 既存機能の拡張: 該当セクションを追加・更新

仕様書の構成

markdown
# 機能名

## 概要
機能の目的と核心思想

## 画面
関連するScreen

## キーバインド
操作方法の一覧表

## データ構造
主要な構造体とフィールド

## 設定(あれば)
設定ファイルと項目

## 関連REQ
関連する要件ドキュメント

2. REQドキュメント (docs/requirements/active/)

  • フロントマターの statuscompleted に変更
  • completed_at を追加
  • 受け入れ基準のチェックボックスをすべて [x] に更新

3. スキルREADME(必要に応じて)

.claude/skills/README.md に新しいスキルを追記

チェックリスト

更新前に以下を確認:

  • 全フェーズの実装が完了しているか
  • テストがパスしているか
  • PRがマージされているか
  • 将来機能が残っていないか(下記参照)

将来機能の切り出し(必須)

REQに以下のような未実装機能が残っている場合、completedにする前に別REQに切り出すこと

  • 「将来的な拡張」「将来検討」セクション
  • 「Phase N(将来)」のような未実装Phase
  • 「スコープ外だが将来対応」のような記述

理由: doneディレクトリに移動すると参照されなくなり、要望が埋もれてしまうため。

手順

  1. REQ内の将来機能を確認
  2. 新規REQを作成(例: REQ-0000010)
    • depends_on: [元のREQ] を設定
    • 将来機能の内容を移動
  3. 元REQから将来機能を削除し、「関連REQ」として参照を追加
  4. 両方のREQをコミット
  5. 元REQをcompletedに変更

使用例

code
ユーザー: REQ-0000002の実装が完了しました
Claude: /spec-updater を実行して仕様書とREQを更新します

出力

更新完了後、以下を報告:

  1. 作成/更新したファイル一覧
  2. REQのステータス変更内容
  3. コミット・PRの作成(必要に応じて)