Skip to content
cccskills
FreePublished on GitHub

workflow-planning

非自明なタスク(3ステップ以上、アーキテクチャ判断、複数ファイルにまたがる変更)に取り組む際の計画・実行・検証サイクル。タスクの開始時、実装がうまくいかず再計画が必要な時、バグ修正やリファクタリングの着手時にこのスキルを参照する。

「計画を立てて」「TODO を整理して」「この機能を実装して」「バグを直して」といったリクエストや、明らかに複数ステップを要するタスクではこのスキルを使う。ただし、大規模な新機能開発(コードベース探索・アーキテクチャ設計・並列レビューが必要な重量級タスク)には feature-dev プラグイン(/feature-dev)の方が適切。

The English summary is being prepared. Showing the original description.

See how to install

Files included (2)

  • SKILL.md3.3 KB
  • README.md2.8 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

ワークフロー計画

計画フェーズ

タスクが以下のいずれかに該当する場合、実装前にプランモードに入る。

  • 3ステップ以上の作業が見込まれる
  • アーキテクチャや設計上の判断を伴う
  • 複数ファイルにまたがる変更

計画は tasks/todo.md にチェックリスト形式で書く。

## [タスク名] - YYYY-MM-DD

- [ ] ステップ1: 具体的な作業内容
- [ ] ステップ2: 具体的な作業内容
- [ ] 検証: テスト実行・動作確認

計画を書いたら、実装開始前にユーザーへ共有して確認を取る。

実行フェーズ

  • 各ステップ完了時に tasks/todo.md のチェックを更新し、何を変更したかの要約を添える
  • うまくいかなくなったら即座に停止して再計画する。無理に突き進まない
  • 実装中に当初の計画では不十分だと気づいたら、計画を修正してからユーザーに共有する

検証フェーズ

タスクを完了とする前に、必ず以下を行う。

  1. リンター・フォーマッタを実行する(pnpm fix 等、プロジェクトの修正コマンド)
  2. テストを実行して通ることを確認する
  3. 変更に関連するログやエラー出力を確認する
  4. 必要に応じて main ブランチとの挙動差分を確認する
  5. tasks/todo.md にレビューセクションを追記する

検証なしにタスクを完了とマークしない。

自律性の境界

以下の場合は確認なしに自律的に進めてよい。

  • 明確なバグ修正(ログ・エラー・テスト失敗を自分で特定し、修正する)
  • CI の失敗テストの修正
  • 計画で合意済みのステップの実行

以下の場合は実行前にユーザーへ確認する。

  • 破壊的変更(API の変更、DB スキーマの変更など)
  • アーキテクチャレベルの判断(新しいライブラリの導入、設計パターンの変更など)
  • 計画にない作業の追加

エレガンスのチェック

非自明な変更では、提示する前に「もっと良い方法はないか」と立ち止まる。修正がハック的に感じたら、今知っていることすべてを踏まえてエレガントな解決策を検討する。

ただし、単純で明白な修正にはこのチェックをスキップする。過剰設計しない。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

This skill should be used when the user asks to "プロジェクトを解析して", "コードベースを調べてドキュメント化して", "移行作業の準備をして", "新機能実装の前にプロジェクトを整理して", "analyze this codebase", "document the project structure", "既存プロジェクトのCLAUDE.mdを作って", or wants to prepare CLAUDE.md and architecture docs before a migration, feature development, or onboarding.

The English summary is being prepared. Showing the original description.

t6adev/claude-code-tools3Updated Apr 9, 2026

This skill should be used when the user asks to "このエラーを直して", "help me debug this", "fix this stack trace", "なぜこのエラーが出るの", "CI が落ちた", or pastes an error message or stack trace and wants help diagnosing it. Classifies the error type, identifies related files, and proposes up to three root-cause hypotheses with concrete fix plans.

The English summary is being prepared. Showing the original description.

t6adev/claude-code-tools3Updated Apr 9, 2026

This skill should be used when the user asks to "ドキュメントを更新して", "sync the docs", "update CLAUDE.md after this change", "実装に合わせてドキュメントを直して", or notices that docs have drifted from the codebase. Diffs git history to identify what changed, proposes targeted updates to CLAUDE.md, docs/architecture.md, docs/requirements.md, and README.md, then applies only approved changes.

The English summary is being prepared. Showing the original description.

t6adev/claude-code-tools3Updated Apr 9, 2026

Explain selected code or a specified file/function in plain language, including what it does, why it exists, and potential pitfalls

The English summary is being prepared. Showing the original description.

t6adev/claude-code-tools3Updated Apr 9, 2026

This skill should be used when the user asks to "このファイルを変えたら何が壊れる?", "what depends on this function", "影響範囲を調べて", "show me what imports this module", or wants to understand the blast radius before modifying a shared utility, exported type, or public API. Traces import/require references up to two levels deep and lists affected test files.

The English summary is being prepared. Showing the original description.

t6adev/claude-code-tools3Updated Apr 9, 2026

This skill should be used when the user asks to "このIssueを実装して", "implement this issue", "fix this bug", "このタスクをやって", "Issue

The English summary is being prepared. Showing the original description.

t6adev/claude-code-tools3Updated Apr 9, 2026

See all skills by t6adev

Report a problem with this skill