القائمة
実装フェーズ等で発覚した設計不備を修正し、整合性を回復させるためのコマンド。
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
استنادا إلى تصنيف SOC المهني
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/takemo101/compose-workflow --skill request-design-fixيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
عرض SKILL.md
| name | request-design-fix |
| description | 実装フェーズ等で発覚した設計不備を修正し、整合性を回復させるためのコマンド。 |
実装フェーズ等で発覚した設計不備を修正し、整合性を回復させるためのコマンド。 実装者が「勝手に直す」のではなく、「設計に戻る」プロセスを正規化します。
$ARGUMENTS
| パラメータ | 必須 | 説明 |
|---|---|---|
issue | ✅ | 関連するGitHub Issue番号 |
target | ✅ | 修正対象の設計書パス |
problem | ✅ | 発生している問題・不備の説明 |
| Phase | 名称 | 内容 |
|---|---|---|
| 0 | 入力検証 | 設計書の存在確認、Issue番号の検証 |
| 0.5 | 影響分析 | 変更の影響範囲、関連設計書の特定 |
| 1 | 問題分析 & 方針策定 | 問題の特定、修正方針の決定 |
| 2 | 設計書修正 | ``detailed-design-writer skill による修正 |
| 2.5 | ユーザー承認（大規模時） | approval-gate skill ※3ファイル以上の場合 |
| 3 | レビューループ | ``detailed-design-reviewer skill によるレビュー（最大3回） |
| 4 | テスト項目書更新 | ``test-spec-writer skill による追従（存在する場合） |
| 5 | 完了通知 | GitHub Issueへのコメント |
Phase規約:
workflow-phase-conventionskill を参照
| 条件 | アクション |
|---|---|
| 最大リトライ回数: 3回 | 3回修正してもレビュー通過しない場合、現状をユーザーに報告して判断を仰ぐ |
| スコア悪化検知 | 修正後にスコアが悪化した場合、即座に中断 |
| 大規模変更検知 | 変更が3ファイル以上に及ぶ場合、Phase 2.5でユーザーに確認 |
target) の存在確認# 設計書の存在確認
test -f "{target}" || echo "Error: 設計書が見つかりません"
# Issue番号の確認
gh issue view {issue} --json state
| チェック項目 | 確認内容 |
|---|---|
| 影響ファイル数 | 修正が複数ファイルに波及するか |
| 関連設計書 | 同一機能の他設計書への影響 |
| API互換性 | 既存APIシグネチャへの影響 |
problem と現在の設計書を比較 skill).md) を更新するトリガー: Phase 0.5で3ファイル以上の変更を検出した場合
共通仕様:
approval-gateskill を参照
## 承認リクエスト: 大規模設計修正
**影響ファイル数**: {count}ファイル
**影響範囲**:
{affected_files_list}
---
**選択肢**:
1. 続行 → Phase 3（レビュー）へ進む
2. 中断 → 修正を中断、手動対応を推奨
3. 再分析 → 影響範囲を絞って再分析
> 番号を選択してください（1-3）:
skill)| 条件 | アクション |
|---|---|
| スコア >= 9 | Phase 4へ |
| スコア < 9 | Phase 2に戻り修正（最大3回） |
| スコア悪化 | 即時中断 |
skill)GitHub Issueに以下のフォーマットでコメントする。
## :wrench: 設計修正完了 (Design Fix)
**修正対象**: `{target}`
**修正内容**:
[修正の概要]
**実装者へのメッセージ**:
設計書が更新されました。最新の設計書とテスト項目書をPullして、実装を再開してください。
| 状況 | 対処法 |
|---|---|
| 設計書が存在しない | エラー報告、正しいパスをユーザーに確認 |
| 問題の特定が困難 | 追加情報をユーザーに要求 |
| 修正が複数設計書に波及 | 影響範囲を報告し、ユーザー承認後に実行 |
| レビュー3回失敗 | 現状の問題点をまとめて報告、手動対応を推奨 |
| テスト項目書が存在しない | 警告を出して続行（テスト更新をスキップ） |
このコマンドは、実装作業中の「割り込み」として機能します。 実装タスクを一時停止し、設計修正タスクを優先実行し、完了後に実装タスクへ戻るよう制御してください。
def request_design_fix(issue: int, target: str, problem: str):
"""
設計修正リクエストの実行
Args:
issue: GitHub Issue番号
target: 修正対象の設計書パス
problem: 問題・不備の説明
"""
# 0. 入力検証
if not file_exists(target):
return error(f"設計書が見つかりません: {target}")
# 1. 問題分析 & 方針策定
current_design = read(target)
analysis = analyze_problem(current_design, problem)
if analysis.scope == "large":
# 大規模変更の場合はユーザー確認
approval = await_user_approval(f"""
大規模な変更が必要です。
影響ファイル: {analysis.affected_files}
続行しますか？
""")
if not approval:
return cancelled()
# 2. 修正・レビューループ
history = []
for i in range(3): # 最大3回リトライ
# 設計書修正
task(
subagent_type="detailed-design-writer",
description=f"設計書修正: {target}",
prompt=f"""
## 修正対象
{target}
## 問題
{problem}
## 修正方針
{analysis.fix_plan}
## 注意
- 変更は局所化すること
- 既存の整合性を壊さないこと
"""
)
# レビュー
review = task(
subagent_type="detailed-design-reviewer",
description=f"修正レビュー: {target}",
prompt=f"修正後の{target}をレビューしてください"
)
review.score >= :
i > review.score < history[-]:
fail()
history.append(review.score)
:
fail()
test_spec = find_test_spec(target)
test_spec:
task(
subagent_type=,
description=,
prompt=
)
comment_on_issue(issue, )
success()
| スキル | 用途 |
|---|---|
approval-gate skill | ユーザー承認ゲート（大規模変更時） |
workflow-phase-convention skill | Phase命名規約 |
docs/designs/detailed/**/*.md skill| バージョン | 変更内容 |
|---|---|
| v2.0 | Phase構造に再構成、全体フロー表追加、承認ゲート追加 |
| v1.0 | 初版 |