hrt-backlog-reconcile について
hrt-backlog-reconcile は、延期項目をリリース済みの OpenSpec 要件と照合する、ユーザーが実行するスキルです。完全または一部カバーされた項目を示し、ユーザーが確認したものだけを削除します。
主な機能
- 01バックログ項目と OpenSpec 仕様の照合
- 02カバー済み・一部カバー済み項目の特定
- 03削除前の確認
- 04バックログファイルとヘッダーの保持
活用シーン
- 01OpenSpec の変更をアーカイブした後の延期作業の整理
- 02リリース済み仕様でカバーされた項目の確認
- 03一部カバーされた項目の残作業の確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ hash-id/ openspec-schema --skill hrt-backlog-reconcileインストール後、Claude Code で/hrt-backlog-reconcileを入力して読み込まれたか確認します。
詳細
hrt-backlog-reconcile
openspec/BACKLOG.md には、ほかの変更を計画する際に先送りされたスライスが記録されています(hrt-change-size-gate によって書き込まれます)。エントリーは手作業で削除されるまで残るため、リリース済みの作業で一部が対応済みでも、そのまま残り、discovery が古くなったインタビューのコンテキストとして読み込み続けます。このスキルは、バックログを実際にリリースされた内容と照合します。
schema.yaml の指示から呼び出されることはありません。ユーザーが呼び出した場合のみ実行されます(/hrt-backlog-reconcile)。変更の差分仕様が openspec/specs/ に取り込まれた直後、openspec archive <change> の直後に実行するのが最適ですが、いつでも実行できます。
手順
openspec/BACKLOG.mdを読み込みます。ファイルが存在しない、またはエントリーがない場合は、その旨を伝えて終了します。- 各エントリーの
Slice:行を取り上げ、openspec/specs/**/*.mdの要件と照らし合わせて判断します。- 対応済み — リリース済みの要件によって、デモ可能な振る舞いが実現されています。エントリーの削除を提案します。
- 一部対応済み — 残っている部分を報告し、削除は提案しません。
- 未対応 — そのまま残し、何も言いません。 文字列の一致ではなく、意味に基づいて判断します。機能名が共通しているだけでは、対応済みの証拠になりません。
- 削除の提案と一部対応済みの注記を、エントリーごとに順番に提示します。エントリー名を示し、その
Slice:行を引用し、対応する要件を示したうえで、ユーザーに確認を求めます。plain-language-writingスキルの COMMS ルールに従います。 - 確認された削除のみ適用します。エントリーのブロック全体(
## <slug>の見出しから最後の-行まで)を削除します。ファイルが空になっても# Deferred Slicesヘッダーは残します。ファイルを削除してはいけません。 - 削除した内容と残した内容を報告します。
エントリーの形式(hrt-change-size-gate と同期)
## <slug-kebab>
- Raised by: <change-id> (<YYYY-MM-DD>)
- Slice: <1–2 sentences: what a user can demo when this slice is done>
- Deferred because: <blocking dependency / scope / capacity>
ファイルが存在する場合のヘッダー:
# Deferred Slices
> Slices raised while planning another change, deliberately deferred. Not proposals - just enough to start a `discovery` session. Delete an entry when it becomes a change.
hrt-change-size-gate は proposal 中のこのファイルへの書き込み(分割時の追加、および自身の変更で対応するエントリーの削除)を担当します。このスキルは手動実行時の照合を担当します。どちらも上記の形式に従います。
制限事項
- 仕様に基づく判定のみです。
Raised byの変更が破棄され、openspec/specs/に痕跡がないエントリーはここでは検出されません。そのようなエントリーは手作業で削除してください。 - 手順 3 には対話形式でのユーザー確認が必要です。非対話形式で実行する場合は、削除候補を報告して編集せずに終了します。
コメント
Markdown 対応