126 lines
4.3 KiB
Markdown
126 lines
4.3 KiB
Markdown
# posimai-kit
|
||
|
||
AIに開発を頼む時の「質問テンプレート」5つのセットです。
|
||
|
||
アイデアをざっくり言葉にするだけで、AIがタスク分解・実装・レビューまで
|
||
一貫した流れで進めてくれるようになります。
|
||
|
||
---
|
||
|
||
## 誰のためのものか
|
||
|
||
- AIを使って何かを作ってみたいけど、何をどう頼めばいいかわからない人
|
||
- AIに頼むたびに出力がバラバラで、途中から迷子になる人
|
||
- エンジニアではないけど、自分のアイデアをかたちにしたい人
|
||
|
||
**コードを書く必要はありません。**
|
||
|
||
---
|
||
|
||
## はじめ方（3ステップ）
|
||
|
||
**1. このリポジトリを手元に置く**
|
||
|
||
```bash
|
||
# Git が使える場合
|
||
git clone https://github.com/あなたのアカウント/posimai-kit.git
|
||
|
||
# Git を使わない場合
|
||
# 右上の「Code」→「Download ZIP」でダウンロードして解凍する
|
||
```
|
||
|
||
**2. `prompts/00_clarify.md` をテキストエディタで開く**
|
||
|
||
VSCode・メモ帳・どのエディタでも構いません。
|
||
|
||
**3. 「私のアイデア」欄に書いて、ファイル全体を AI に貼り付ける**
|
||
|
||
Claude・ChatGPT・Gemini、どの AI でも使えます。
|
||
AI の回答は、メモ帳や Notion など手元に保存してください。
|
||
|
||
---
|
||
|
||
## 使い方：5つのステップ
|
||
|
||
```
|
||
あなたのアイデア（ざっくりでOK）
|
||
│
|
||
▼
|
||
┌─────────────────────────────────────────────────────┐
|
||
│ 00_clarify.md 「仕様を整理して」 │
|
||
│ ↓ アイデアが言語化される │
|
||
│ 10_breakdown.md 「タスクに分解して」 │
|
||
│ ↓ やることリストができる │
|
||
│ 20_implement.md 「T-001を作って」← 1つずつ繰り返す │
|
||
│ ↓ コードが生まれる │
|
||
│ 30_review.md 「確認して」 │
|
||
│ ↓ 問題点が見つかる・修正する │
|
||
│ 40_debug.md 「直して」← 何か壊れた時だけ │
|
||
└─────────────────────────────────────────────────────┘
|
||
│
|
||
▼
|
||
動くものができる
|
||
```
|
||
|
||
---
|
||
|
||
## 入力はざっくりでOK
|
||
|
||
テンプレートに貼り付けるアイデアは、整理されていなくて大丈夫です。
|
||
「整理する」のが `00_clarify.md` の役割だからです。
|
||
|
||
**あなたが書くもの（これで十分）**
|
||
|
||
```
|
||
家計簿アプリを作りたい。スマホで使いたい。
|
||
レシートを写真で撮れたら嬉しいけど最初は手入力でも。
|
||
家族で共有できたらいいけど後でもいい。
|
||
```
|
||
|
||
**AIが整理して出してくれるもの**
|
||
|
||
```
|
||
目的: 支出を記録・可視化して、使いすぎを防ぐ
|
||
|
||
スコープ内（今回作る）:
|
||
- 収支の手動入力
|
||
- カテゴリ分類
|
||
- 月次グラフ表示
|
||
|
||
スコープ外（後回し）:
|
||
- レシートの自動読み取り
|
||
- 家族共有機能
|
||
|
||
MVP定義: 入力→一覧→グラフの3画面が動けばリリース可
|
||
```
|
||
|
||
記入済みのサンプルは [examples/](examples/) を参照してください。
|
||
|
||
---
|
||
|
||
## ファイル一覧
|
||
|
||
| ファイル | 何のためか |
|
||
|---|---|
|
||
| `prompts/00_clarify.md` | ぼんやりしたアイデアを仕様に変える |
|
||
| `prompts/10_breakdown.md` | 仕様を小さなタスクに分解する |
|
||
| `prompts/20_implement.md` | 1タスクをAIに実装してもらう |
|
||
| `prompts/30_review.md` | できたコードを別のAIに検査させる |
|
||
| `prompts/40_debug.md` | 動かない時に原因を切り分ける |
|
||
| `examples/` | 記入済みサンプル（参考用） |
|
||
| `docs/workflow.md` | フロー詳細 |
|
||
| `docs/troubleshooting.md` | よくある詰まりポイント |
|
||
|
||
---
|
||
|
||
## AIツール（Claude Code・Cursor）を使っている場合
|
||
|
||
プロジェクトのルートに `AGENTS.md` と `CLAUDE.md` を置くと、
|
||
AIが毎回同じルールで動くようになります。どちらも任意です。
|
||
|
||
---
|
||
|
||
## ライセンス
|
||
|
||
MIT — 自由に使用・改変・配布できます。
|