mcpField
W
writing-plans

writing-plans

github.com/zenobi-us開発6835 回インストール今日更新
リポジトリ

writing-plans について

合意済みの仕様を、段階的な実装計画にまとめるスキルです。コードベースに不慣れなエンジニア向けに、タスク、テスト、ドキュメント確認、実行時の引き継ぎを記述します。

主な機能

  1. 012～5分単位で作業を分割
  2. 02ファイルパスと正確なコマンドを記載
  3. 03テストと期待結果を明示
  4. 04DRY、YAGNI、TDDに沿った計画
  5. 05実行方法の引き継ぎを提示

活用シーン

  1. 01仕様確定後の実装計画作成
  2. 02コードベースに不慣れなエンジニアの案内
  3. 03コミット手順を含むテスト先行タスクの準備

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/zenobi-us/dotfiles --skill writing-plans

インストール後、Claude Code で/writing-plansを入力して読み込まれたか確認します。

詳細

仕様がまだない場合は、このスキルを使用しないでください。まずブレインストーミングまたは仕様作成のスキルを使用してください。

計画の作成

概要

コードベースの知識がまったくなく、判断力にも疑問のあるエンジニアを想定して、包括的な実装計画を作成します。各タスクで変更するファイル、コード、テスト、確認が必要なドキュメント、テスト方法など、必要な情報をすべて記載してください。計画全体を、取り組みやすい小さなタスクに分けてください。DRY。YAGNI。TDD。こまめにコミットします。

エンジニアは熟練した開発者ですが、ツールセットや問題領域についてはほとんど知らず、適切なテスト設計にも詳しくないと想定してください。

開始時に次のように宣言します：「実装計画を作成するため、writing-plans スキルを使用します。」

**コンテキスト：**ブレインストーミングスキルで作成した専用のワークツリーで実行してください。

計画の保存先： scopecraft ツールを使用します

取り組みやすいタスクの粒度

各ステップは1つの作業（2～5分）です：

  • 「失敗するテストを書く」- ステップ
  • 「テストを実行して失敗することを確認する」- ステップ
  • 「テストを通すための最小限のコードを実装する」- ステップ
  • 「テストを実行して成功することを確認する」- ステップ
  • 「コミットする」- ステップ

計画ドキュメントのヘッダー

すべての計画は必ずこのヘッダーから始めてください：

---
insert frontmatter here
---
# [Feature Name] Implementation Plan

> **For Claude:** REQUIRED SUB-SKILL: Use superpowers:executing-plans to implement this plan task-by-task.

**Goal:** [One sentence describing what this builds]

**Architecture:** [2-3 sentences about approach]

**Tech Stack:** [Key technologies/libraries]

タスクの構成

### Task N: [Component Name]

**Files:**
- Create: `exact/path/to/file.py`
- Modify: `exact/path/to/existing.py:123-145`
- Test: `tests/exact/path/to/test.py`

**Step 1: Write the failing test**

```python
def test_specific_behavior():
    result = function(input)
    assert result == expected

ステップ 2：テストを実行して失敗することを確認する

実行：pytest tests/path/test.py::test_name -v 想定：function not defined というエラーで FAIL

ステップ 3：最小限の実装を書く

def function(input):
    return expected

ステップ 4：テストを実行して成功することを確認する

実行：pytest tests/path/test.py::test_name -v 想定：PASS

ステップ 5：コミットする

git add tests/path/test.py src/path/file.py
git commit -m "feat: add specific feature"


## Remember
- Exact file paths always
- Complete code in plan (not "add validation")
- Exact commands with expected output
- Reference relevant skills with @ syntax
- DRY, YAGNI, TDD, frequent commits

## Execution Handoff

After saving the plan, offer execution choice:

**"Plan complete and saved to `docs/plans/<filename>.md`. Two execution options:**

**1. Subagent-Driven (this session)** - I dispatch fresh subagent per task, review between tasks, fast iteration

**2. Parallel Session (separate)** - Open new session with executing-plans, batch execution with checkpoints

**Which approach?"**

**If Subagent-Driven chosen:**
- **REQUIRED SUB-SKILL:** Use superpowers:subagent-driven-development
- Stay in this session
- Fresh subagent per task + code review

**If Parallel Session chosen:**
- Guide them to open new session in worktree
- **REQUIRED SUB-SKILL:** New session uses superpowers:executing-plans

コメント

Markdown 対応