run-skill-rename · diff
v0.1.0 to v0.1.0
3 added, 0 removed. Audit A to A.
---
name: run-skill-rename
description: Skill名を変更するとき、改名後の参照整合を確認するときに使う。
disable-model-invocation: false
user-invocable: true
argument-hint: "[old-skill-name] [new-skill-name]"
arguments: [old_name, new_name]
allowed-tools:
- Read
- Write
- Edit
- Bash(python3 *)
- Bash(git *)
kind: run
prefix: run
+ goal_seek:
+ engine: inline
+ fork: inline
owner: team-platform
since: 2026-05-18
version: 0.1.0
# doc/21 source-traceability
source: doc/ClaudeCodeスキルの設計書/06-classification-and-naming.md
source-tier: internal
last-audited: 2026-05-19
audit-trigger: source-update
effect: local-artifact
responsibility_refs:
- prompts/R1-rename.md
schema_refs:
- schemas/output.schema.json
manifest: workflow-manifest.json
feedback_contract: # per-skill 評価基準(SSOT=scripts/feedback_contract_ssot.py)。content-review verdict の criteria_evaluated と突合
activation_state: semantic_evaluator_started
max_iterations: 3
criteria:
- id: IN1
loop_scope: inner
text: 改名後の新名 SKILL.md が lint-skill-name と lint-skill-tree と validate-frontmatter を全て exit0 で通過する
verify_by: lint
- id: IN2
loop_scope: inner
text: ディレクトリ改名が git mv で履歴保持され frontmatter.name が新名へ更新され aliases に旧名が登録された不可分セットが全て満たされる
verify_by: script
- id: OUT1
loop_scope: outer
text: OUT_BASE 配下 SKILL.md 全体の pair と Skill() 旧名参照を漏れなく走査し全ヒットが新名へ更新され参照切れが残らない
verify_by: elegant-review
artifact_delivery:
contract: artifact-delivery-v1
state_machine:
initial: artifact_created
states: [artifact_created, minimal_guard_passed, artifact_presented, user_choice_recorded, semantic_evaluator_started, handoff_complete]
transitions:
- {from: artifact_created, event: minimum_guard_pass, to: minimal_guard_passed}
- {from: minimal_guard_passed, event: present_actual_artifact, to: artifact_presented}
- {from: artifact_presented, event: record_user_choice, to: user_choice_recorded}
- {from: user_choice_recorded, event: accept-as-is, to: handoff_complete}
- {from: user_choice_recorded, event: "light|standard|detailed", to: semantic_evaluator_started}
- {from: semantic_evaluator_started, event: improvement_complete, to: handoff_complete}
pre_choice_forbidden: [semantic-evaluator, task-fork, subagent, multi-worker, revise-loop]
accept_contexts: {evaluator: 0, improver: 0}
release: explicit-only
exhaustive: explicit-only
---
## Pre-choice usable artifact execution
Purpose & Output Contractの最小の実成果物をmain contextで作成する。effect別のparse/open・secret・irreversible・corrupt guardだけを実行し、現物path・digest・開き方を提示してからaccept-as-is/light/standard/detailedを記録する。accept-as-isはその場でhandoff完了とし、後続sectionを実行しない。
## Post-choice selected improvement execution
以下の既存workflow・goal-seek・評価・修正sectionはlight/standard/detailedが記録されて`semantic_evaluator_started`へ遷移した場合だけ実行する。release/exhaustiveは別の明示eventを必要とする。
# run-skill-rename
## Purpose & Output Contract
スキルを安全に改名するワークフロー（A5/C2: 未実装スキルの新規作成）。
**入力**: old_name (現在のスキル名), new_name (新しいスキル名)
**出力**:
- 改名済みディレクトリ `$OUT_BASE/<new-name>/`
- SKILL.md frontmatter の `name:` 更新
- `aliases:` に旧名を追加
- `CHANGELOG.md` に改名エントリ追加
- 参照元スキルの `pair:` / `Skill()` 記述を新名に更新
**完了条件**: lint-skill-name.py, lint-skill-tree.py が exit 0。
## Key Rules
1. **ディレクトリ名 == frontmatter.name**: 第8条。改名後は両方を同時更新。
2. **alias必須**: 旧名を `aliases:` に登録して参照切れを防ぐ（第6条）。
3. **CHANGELOG必須**: 改名エントリを `references/CHANGELOG.md` に追加（第6条）。
4. **参照元更新**: `pair:` / `Skill()` の旧名参照を新名に更新する。
5. **gitの履歴保持**: `git mv` を使い、ファイル移動の履歴を残す。
## ゴールシーク実行
### ゴール (Goal)
旧名スキルが `$OUT_BASE/<new-name>/` へ git 履歴を保ったまま改名され、frontmatter.name・aliases・CHANGELOG・全参照元 (`pair:`/`Skill()`) が新名で整合し、lint-skill-name.py / lint-skill-tree.py が exit 0 の状態になっている。
### 目的・背景 (Why)
ディレクトリ名・frontmatter.name・参照は同時に一致させないと参照切れを生む (第8条)。部分更新で不整合が起きやすいため、固定手順ではなく「全箇所が新名で整合した状態」へ向けて未達箇所を都度埋める。
### 完了チェックリスト (Checklist)
- [ ] `resolve-skill-dirs.py` で `$OUT_BASE` (eval-log/skill-dirs.json) が解決済み
- [ ] 旧名 `$OUT_BASE/$OLD_NAME/SKILL.md` の存在を確認済み、新名 `$OUT_BASE/$NEW_NAME` は未存在 (重複なし)
- [ ] 新名が `lint-skill-name.py --name "$NEW_NAME"` の命名規約を通過
- [ ] ディレクトリが `git mv` で改名され git 履歴が保持されている (rm+mkdir 禁止)
- [ ] 新 SKILL.md frontmatter の `name:` が `$NEW_NAME` に更新され、`aliases:` に `$OLD_NAME` が登録されている (第6条、参照切れ防止)
- [ ] `references/CHANGELOG.md` に改名エントリ (date / 旧→新 / Reason / aliases) が追記されている (第6条)
- [ ] `pair:` / `Skill()` の旧名参照を `$OUT_BASE/` 配下 SKILL.md 全体から grep し、ヒット各所が新名へ更新されている
- [ ] `lint-skill-name.py`・`lint-skill-tree.py`・`validate-frontmatter.py` (新 SKILL.md) が全て exit 0
### ゴールシークループ
正本 `../run-build-skill/references/goal-seek-paradigm.md` の 6 ステップ (現状評価→手順生成→実行→検証→Anchor Step→反復/差し戻し) に従う。本スキル固有の差分:
- **対象パス**: `$OUT_BASE` は `resolve-skill-dirs.py` 出力。入出力は `$OUT_BASE/$OLD_NAME` → `$OUT_BASE/$NEW_NAME`。
- **不可分セット**: ディレクトリ改名・frontmatter.name・aliases は必ずひとまとめで満たす (どれか欠けると参照不整合)。
- **検証コマンド**: `lint-skill-name.py "$OUT_BASE/$NEW_NAME/SKILL.md"` / `lint-skill-tree.py "$OUT_BASE/$NEW_NAME"` / `validate-frontmatter.py`。いずれか非 0 なら frontmatter/参照更新へ差し戻す。
- 参照元検索: `grep -r "$OLD_NAME" "$OUT_BASE/" --include="SKILL.md" -l`。
## Gotchas
- **git mv 省略禁止**: `rm` + `mkdir` で移動すると git 履歴が途切れる。
- **alias 追加忘れ**: alias なしで旧名参照があると呼び出し先が消える。
- **CHANGELOG 省略禁止**: 第6条違反。CI で検出される。
- **部分更新**: ディレクトリ名だけ or frontmatter だけの更新は不整合を生む。改名・frontmatter.name・aliases は必ずセットで満たす。
## Additional Resources
- `06-classification-and-naming.md` — 命名規約 第6条（改名手続き）
- `13-checklists.md` — 命名規約条文チェックリスト
- `plugins/skill-governance-lint/scripts/lint-skill-name.py` — 命名検証
- `plugins/harness-creator/skills/run-build-skill/scripts/resolve-skill-dirs.py` — OUT_BASE 解決スクリプト