mcpField
W
writing-plans

writing-plans

github.com/makerjackieエージェントワークフロー139 回インストール36 週間前に更新
リポジトリ

writing-plans について

writing-plansは、機能要件を実装計画にまとめるスキルです。コードベースに詳しくない開発者向けに、ファイル、コマンド、期待結果、コミットを含む小さな検証可能な手順を示します。

主な機能

  1. 01順序立てた小さな実装手順
  2. 02ファイルとテストコマンドの明記
  3. 03テスト先行のタスク構成
  4. 04計画の保存先と実行引き継ぎ

活用シーン

  1. 01不慣れなコードベースでの機能計画
  2. 02テスト駆動の実装手順の準備

インストール

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

$npx skills add https://github.com/makerjackie/jackie-skills-starter --skill writing-plans

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

詳細

（中文）計画の作成

概要

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

熟練した開発者であることを前提としますが、ツールセットや問題領域についてはほとんど知らないと想定してください。適切なテスト設計についても、あまり詳しくないと想定してください。

最初に宣言する内容： 「writing-plans スキルを使って、実装計画を作成します。」

コンテキスト： これは、brainstorming スキルで作成した専用のワークツリーで実行します。

計画の保存先： docs/plans/YYYY-MM-DD-<feature-name>.md

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

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

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

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

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

# [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
```

**Step 2: Run test to verify it fails**

Run: `pytest tests/path/test.py::test_name -v`
Expected: FAIL with "function not defined"

**Step 3: Write minimal implementation**

```python
def function(input):
    return expected
```

**Step 4: Run test to verify it passes**

Run: `pytest tests/path/test.py::test_name -v`
Expected: PASS

**Step 5: Commit**

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

忘れずに

  • ファイルパスは必ず正確に記載します
  • 計画には完全なコードを記載します（「バリデーションを追加」などとは書きません）
  • 期待される出力を含む、正確なコマンドを記載します
  • 関連するスキルを @ 構文で参照します
  • DRY、YAGNI、TDD、こまめなコミットを守ります

実行方法の選択

計画を保存したら、実行方法を選べるように案内します：

「計画が完成し、docs/plans/<filename>.md に保存されました。実行方法は2つあります：

1. サブエージェント方式（このセッション） - タスクごとに新しいサブエージェントを起動し、タスク間でレビューを行いながら、迅速に反復します

2. 並行セッション方式（別セッション） - executing-plans を使って新しいセッションを開き、チェックポイントを設けてまとめて実行します

どちらの方法にしますか？」

サブエージェント方式を選んだ場合：

  • 必須のサブスキル： superpowers:subagent-driven-development を使用します
  • このセッションを継続します
  • タスクごとに新しいサブエージェントを起動し、コードレビューを行います

並行セッション方式を選んだ場合：

  • ワークツリーで新しいセッションを開くよう案内します
  • 必須のサブスキル： 新しいセッションでは superpowers:executing-plans を使用します

コメント

Markdown 対応