simplify について
タスクの実装を要件とプロジェクト標準に照らして確認する品質ゲート用スキルです。指摘をタスク文書に記録し、テストに進む前に PASS または FAIL を返します。
主な機能
- 01タスク範囲と変更ファイルのみを確認
- 02要件と受け入れ条件を照合
- 03逸脱を重大度別に分類
- 04指摘をタスク文書に記録
- 05PASS または FAIL を返却
活用シーン
- 01テスト前の実装確認
- 02範囲拡大や重大な逸脱の検出
- 03タスク文書がない小規模変更のレビュー
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ eljun/ claude-workflow-skills --skill simplifyインストール後、Claude Code で/simplifyを入力して読み込まれたか確認します。
詳細
simplify - 品質ゲートステージ
不変条件
- タスクのスコープと変更されたファイルのみをレビューします。
- 新たなプロダクトスコープを追加しません。
- テストの前に重大な逸脱を阻止します。
- 長期的に参照できる所見をタスクドキュメントに記録します。
- タスクドキュメントに
Implementation Notesセクションがあり、TASKS.mdで該当行がまだPlannedまたはIn Progressになっている場合は、続行する前に該当行をTestingに更新してください。実装は実行されましたが、トラッカーの更新が漏れています。Implementation Notesがない場合は更新しないでください。実装は実際に実行されていないため、その旨をユーザーに伝えてください。
ランタイムアダプターでは、このステージをスラッシュコマンド、メニューアクション、または自然言語によるスキル呼び出しとして公開できます。移植可能なステージ名は simplify です。
ワークフロー
AGENTS.mdを読みます。- タスク ID を特定し、
docs/task/{ID}-{task-name}.mdを読みます。 Implementation Notesとgit diff --name-onlyから変更されたファイルを特定します。- 変更されたファイルのみを読みます。
- コーディング標準と保守性を確認します。
- 実装を要件、ファイル変更、スコープ外の境界、受け入れ条件と照合します。
- 逸脱を分類します。
Quality Gate Notesをタスクドキュメントに追記します。- PASS または FAIL を返します。
タスクドキュメントがない場合
ユーザーから直接依頼された小規模な変更で、docs/task/ のドキュメントがない場合(簡単な修正や調整など):
- タスクドキュメントの代わりに、ベースブランチとの差分(
git diff)をユーザーの依頼と照合してレビューします。 - 同じ標準チェックリストと逸脱レベルを適用します。「スコープ」とは、ユーザーが依頼した内容です。
- 結果(
PASS/FAIL、所見、逸脱)を新しいタスクドキュメントではなく、プルリクエスト本文またはコミットメッセージに記録します。 - プロジェクトから求められていない限り、このために
TASKS.mdの行を作成しないでください。
標準チェックリスト
該当する項目を適用します。
- 未使用コード、デッドコード、コメントアウトされた実装がないこと
- プロジェクトに型付きの代替手段がある場合、広範な
anyや型付けを回避する手段を使っていないこと - ガード節を使うほうが明確な箇所で、深いネストになっていないこと
- 関数とファイルの責務が明確であること
- 名前が動作を正確に表していること
- 繰り返しによって保守上のリスクが生じる場合、繰り返しのロジックを抽出していること
- エラーを意図的に処理していること
- 本番経路にシークレット、認証情報、デバッグログがないこと
- 古い動作や文言を検証するテストは、削除するのではなく、理由をコメントで説明したうえで意図的に更新されていること
- 新規または変更されたテストでは、可能な限り動作または出力を検証していること。ソーステキストや構造のみを検証するテストは、証拠として不十分であると指摘します
- タスクドキュメントのすべての受け入れ条件に、失敗判定が可能なチェックがあること。該当しない条件があれば指摘します
AGENTS.md、LEARNINGS.md、タスクドキュメントにあるプロジェクトの規約に従っていること
逸脱の分類
| レベル | 意味 | 結果 |
|---|---|---|
| 軽微 | スコープを満たしている、小さな実装上の相違です。 | 記録して続行します。 |
| 中程度 | ユーザーに知らせるべき、意味のある相違です。 | リスクが許容できる場合に限り、記録して続行します。 |
| 重大 | 要件に違反する、スコープを拡大する、または承認なしにアーキテクチャを変更するものです。 | FAIL として停止します。 |
タスクドキュメントへの出力
## Quality Gate Notes
### Result
PASS | FAIL
### Standards Review
- {Finding or "No blocking issues"}
### Deviations
- {Deviation level and rationale}
### Required Fixes
- {Only if FAIL}
引き継ぎ
PASS:
Quality gate passed for task {ID}
Next stage: test {ID}
FAIL:
Quality gate failed for task {ID}
Return to implementation with the required fixes listed in the task document.
コメント
Markdown 対応