xddp-revise

You are executing XDDP Revise — Apply Human Review Comments.

Arguments: $ARGUMENTS = [CR_NUMBER] (optional) DOCUMENT_TYPE [REPO_NAME] [IDS]

• CR_NUMBER: optional; auto-detected from XDDP_DIR if omitted
• DOCUMENT_TYPE: analysis | req | arch | design | test | (file path)
• REPO_NAME: optional; which repo's artifact to revise (for arch/design/test in multi-repo). If omitted and IS_MULTI, ask the user.
• IDS: optional; comma-separated review item numbers to apply (e.g. 1,3). If omitted, all ⬜ 未対応 items are targeted.

---

Read ~/.claude/skills/xddp-common/SKILL.md, apply "## CR Resolution" with $ARGUMENTS → let CR, REST_ARGS. Let DOC_TYPE = first token of REST_ARGS. Let remaining = tokens after DOC_TYPE. If remaining is empty: let IDS = empty; let REPO_NAME = empty. Else if last token of remaining matches ^[0-9]+(,[0-9]+)*$: let IDS = that token (parse as comma-separated int list). let REPO_NAME = remaining minus IDS token (may be empty if remaining had only one token). Note: repo names consisting solely of digits are indistinguishable from IDS by this rule. Such names should not be used; if unavoidable, the user must specify REPO_NAME before IDS. Else: let IDS = empty; let REPO_NAME = remaining (second token of REST_ARGS). Note: strings that do not match ^[0-9]+(,[0-9]+)*$ (e.g., 1,abc,3) are intentionally treated as REPO_NAME, not IDS. Such tokens would cause a file-not-found error in Step 1, alerting the user. If IS_MULTI and arch/design/test/specout is selected and REPO_NAME is empty: ask the user which repo (cross も選択肢に含める)。 If NOT IS_MULTI and arch/design/test/specout is selected and REPO_NAME is empty: If REPOS_KEYS is empty: error "REPOS: が xddp.config.md に設定されていません"; stop. set REPO_NAME = REPOS_KEYS[0].

(xddp.config.md lookup done in xddp-common/SKILL.md「## CR Resolution」; reuse WORKSPACE_ROOT, XDDP_DIR, REPOS_KEYS, IS_MULTI.) Let CR_PATH = {WORKSPACE_ROOT}/{XDDP_DIR}/{CR}.

1. Resolve target file

DOC_TYPE	File
analysis	{CR_PATH}/02_analysis/ANA-{CR}.md
req	{CR_PATH}/03_change-requirements/CRS-{CR}.md
specout	REPO_NAME 未指定かつ IS_MULTI: ユーザーに確認（cross も選択肢に含める）; 単一リポジトリ: REPOS_KEYS[0] を REPO_NAME として使用。NOT IS_MULTI で REPO_NAME が "cross" の場合はエラー「シングルリポジトリ構成には cross 成果物は存在しません」で停止。REPO_NAME が "cross" の場合: {CR_PATH}/04_specout/cross/SPO-{CR}-cross.md。それ以外: {CR_PATH}/04_specout/{REPO_NAME}/SPO-{CR}.md
arch	以下の手順でファイルを特定する:<br>1. REPO_NAME を解決する（未指定かつ IS_MULTI: ユーザーに確認、cross も選択肢に含める; 単一リポジトリ: REPOS_KEYS[0] を使用。NOT IS_MULTI で REPO_NAME が "cross" の場合はエラー「シングルリポジトリ構成には cross 成果物は存在しません」で停止）<br>2. REPO_NAME が "cross" の場合: {CR_PATH}/05_architecture/cross/DSN-{CR}-cross.md を修正対象とし、手順3・4はスキップする（cross DSN は比較案を持たない単一ファイルとして直接生成されるため。xddp-05-arch/SKILL.md「## Step A-cross」参照）<br>3. {CR_PATH}/05_architecture/{REPO_NAME}/DSN-{CR}-comparison.md が存在する場合: 「比較ファイル（comparison.md）、案ファイル（approach-A.md, approach-B.md, ...）のいずれを修正しますか？」とユーザーに確認し、対象ファイルを決定する。<br>4. comparison.md が存在しない場合（1案）: {CR_PATH}/05_architecture/{REPO_NAME}/DSN-{CR}-approach-A.md を修正対象とする。
design	「## 1a. design 対象ファイルの解決」参照
test	REPO_NAME 未指定かつ IS_MULTI: ユーザーに確認（cross も選択肢に含める）; 単一リポジトリ: REPOS_KEYS[0] を REPO_NAME として使用。NOT IS_MULTI で REPO_NAME が "cross" の場合はエラー「シングルリポジトリ構成には cross 成果物は存在しません」で停止。REPO_NAME が "cross" の場合: {CR_PATH}/09_test-spec/cross/TSP-{CR}-cross.md。それ以外: {CR_PATH}/09_test-spec/{REPO_NAME}/TSP-{CR}.md
other	treat as file path

If DOC_TYPE omitted: ask the user which document to revise.

1a. design 対象ファイルの解決

CHDはインデックス＋UR別内容ファイルに分割されている。対象が単一ファイルでなくなるため、 候補をインデックスから提示してユーザーに確認する。

1. REPO_NAME を解決する（未指定かつ IS_MULTI: ユーザーに確認〔cross も選択肢に含める〕; 単一リポジトリ: REPOS_KEYS[0] を使用。NOT IS_MULTI で REPO_NAME が "cross" の場合はエラー「シングルリポジトリ構成には cross 成果物は存在しません」で停止）。
2. Read ~/.claude/skills/xddp-common/SKILL.md, apply "## Discover CHD Files" with: CR_PATH: {CR_PATH}, REPO_NAME: {REPO_NAME}, CR: {CR} → let CHD_CONTENT_FILES.
3. CHD_CONTENT_FILES が複数件の場合: 候補一覧（UR ID・バッチ番号・ファイルパス）をユーザーに提示し、 修正対象とする単一ファイルを選ばせる。1件のみの場合はそのまま使用する。
4. 選択されたファイルを以降の「対象ファイル」として使用する。

2. Load review items

Let REVIEW_FILE = the review file path resolved from DOC_TYPE (Step 4 のパスマッピングと同一。Step 4 自体は変更なし)。

Case A — REVIEW_FILE exists: Read REVIEW_FILE. Extract rows from ## 2. 指摘事項と対応内容 table where 対応状況 = ⬜ 未対応. Let OPEN_ITEMS = list of extracted rows (columns: #, 重要度, 場所, 指摘内容).

If IDS is specified: filter OPEN_ITEMS to those whose # matches any value in IDS. Let MISSING_IDS = values in IDS that had no matching row in OPEN_ITEMS. If MISSING_IDS is non-empty: warn "指定された ID が見つかりませんでした: {MISSING_IDS}（スキップします）". If no items remain after filtering: report "指定された ID に該当する未対応指摘が見つかりませんでした" and stop. (Partial match is intentional — found items are applied; missing IDs are skipped with a warning.)

If OPEN_ITEMS is empty: report "未対応の指摘はありません" and stop.

Display OPEN_ITEMS as a table and tell the user:

以下の指摘を成果物に反映します。よろしいですか？（修正不要な項目があれば番号で除外を指示してください）

Wait for user confirmation. If the user excludes items, remove them from OPEN_ITEMS. Excluded items remain ⬜ 未対応 in the review file (対応状況は更新しない)。

Case B — REVIEW_FILE does not exist: Tell the user:

レビューファイルが見つかりません。修正したい箇所と内容を教えてください。セクション名や行番号（任意）と修正内容をリスト形式で入力してください。

Wait for user input. Treat the user input as OPEN_ITEMS (freeform).

3. Apply revisions

Read the target file. Apply each item in OPEN_ITEMS:

• Minimal, targeted edits only — do not rewrite unaffected sections.
• Maintain document structure, numbering, and TM consistency.

3.5. Ensure output directory exists

Run mkdir -p {parent directory of review file} using Bash to create the review output directory if it does not exist.

4. Record in review file

Update the corresponding review file for the document type:

DOC_TYPE	Review File
analysis	{CR_PATH}/02_analysis/review/02_analysis-review.md
req	{CR_PATH}/03_change-requirements/review/03_change-requirements-review.md
specout	REPO_NAME が "cross" の場合: {CR_PATH}/04_specout/cross/review/04_specout-cross-review.md。それ以外: {CR_PATH}/04_specout/{REPO_NAME}/review/04_specout-review.md（REPO_NAME は上記と同様に解決）
arch	REPO_NAME が "cross" の場合: {CR_PATH}/05_architecture/cross/review/05_architecture-cross-review.md。それ以外: {CR_PATH}/05_architecture/{REPO_NAME}/review/05_architecture-review.md（REPO_NAME は上記と同様に解決）
design	REPO_NAME が "cross" の場合: {CR_PATH}/06_design/cross/review/06_design-cross-review.md（cross CHD は単一ファイルのため UR-ID/バッチ番号は付与しない）。それ以外: {CR_PATH}/06_design/{REPO_NAME}/review/06_design-review-{UR-ID}[-{N}].md（REPO_NAME は上記と同様に解決。UR-ID/バッチ番号は「## 1a. design 対象ファイルの解決」で選択したファイルに対応するもの）
test	REPO_NAME が "cross" の場合: {CR_PATH}/09_test-spec/cross/review/09_test-spec-cross-review.md。それ以外: {CR_PATH}/09_test-spec/{REPO_NAME}/review/09_test-spec-review.md（REPO_NAME は上記と同様に解決）
other	{CR_PATH}/review/manual-review.md

• If file exists:
  • For Case A (auto-loaded from review file): update 対応状況 column of each applied row from ⬜ 未対応 to ✅ 対応済, and fill in 対応内容 column with a summary of the change applied.
  • For Case B (freeform input): append human review items and mark ✅ 対応済.
• If not: create using review template with reviewer "人間（今日の日付）".

5. Increment version

Add 変更履歴 entry: version +0.1, today, author "人", description of changes.

6. Report in Japanese

DOC_TYPE が design で REPO_NAME が cross でない場合、報告の末尾で次を行う（{repo} = REPO_NAME）: Run via Bash: PY=$(command -v python3 || command -v python) && "$PY" ~/.claude/skills/xddp-common/scripts/xddp_progress.py show --cr-path {CR_PATH} --step 6a → state。⬜ 未着手 なら行わない。 Read ~/.claude/skills/xddp-common/procedures/regression-status.md, apply "## Regression Status"（CR: {CR}, CR_PATH: {CR_PATH}, REPO: {repo}, MODE: status）。 FORMAT_ERROR が空でなければ「{repo} の回帰の範囲を確かめられません（CHD §4 の書式の誤り: {FORMAT_ERROR}）。/xddp-revise {CR} design で直してから /xddp-06-design {CR} regression --repo {repo} を実行してください」、それ以外で STALE が true なら「{repo} の回帰の範囲（CHD §7 の回帰の行）が古くなりました。/xddp-06-design {CR} regression --repo {repo} でやり直してください」と伝える。 FORMAT_ERROR が空なら続けて、COCHANGE_FORMAT_ERROR が空でなければ「{repo} の一緒に直す候補を確かめられません（CHD §4.1 の表の書式の誤り: {COCHANGE_FORMAT_ERROR}）。/xddp-revise {CR} design で直してから /xddp-06-design {CR} regression --repo {repo} を実行してください」、それ以外で COCHANGE_STALE が true なら「{repo} の一緒に直す候補（CHD §4・§4.1）が古くなりました。/xddp-06-design {CR} regression --repo {repo} でやり直してください」と伝える。