Cursor 設定早見
Rules / Skills / @Past Chats と Cursor 公式 BP。
Cursor
手順: Cursor 初期設定（リポ）
AGENTS.mdをルートに置く → サンプル.cursor/rules/00-project.mdcをalwaysApply: trueで作成 → Rules サンプル- （任意）
.cursor/commands/にplan.md等 — 本リポはAI_Doc/.cursor/commands/をコピー可 - （任意）
.cursor/skills/<name>/SKILL.md— 週次の多段手順のみ
.cursor/
├── rules/
│ ├── 00-project.mdc # alwaysApply: true
│ └── 10-domain-rules.mdc
├── commands/
│ └── plan.md # → Composer で /plan
├── skills/
│ └── pr-review/SKILL.md
└── plans/ # Plan モード「Save to workspace」
手順: 典型ワークフロー（Cursor）
A. 新機能 — Plan → 実装
- Composer で Shift+Tab → Plan
- プロンプト例を貼る（下記）→ 計画承認 → Build
- 「Save to workspace」→
.cursor/plans/YYYYMMDD-feature.md - 確定内容を
tasks/todo.mdに転記 - AI（Agent）モードで実装 →
/verifyで証拠を残す
/plan 請求PDFエクスポート。参照 @docs/prd/invoice-export.md @tasks/todo.md
Done when: rspec spec/services/invoice_export_spec.rb green
flowchart LR
planNode[Planモードで計画] --> saveNode[plansに保存]
saveNode --> todoNode[todo.mdに転記]
todoNode --> buildNode[Agentで実装]
buildNode --> verifyNode[テストで確認]
B. 別チャットで続き — Past Chats
- 新規 Composer
@Past Chats（前の会話を参照）→ 関連セッション 1 件@tasks/todo.md+ ゴール 1〜3 行
@Past Chats（invoice PDF セッション）
続き: InvoicePdfService のエラーハンドリング。Done when: rspec green
@tasks/todo.md詳細: @Past Chats · /handoff
C. 検証ループ — Hooks（任意）
{
"version": 1,
"hooks": {
"stop": [{ "command": "make test" }]
}
}
配置: .cursor/hooks.json（プロジェクトルート）。失敗時はエージェントが再試行しやすくなる。
D. PR 前
/review @Branch の差分。ブロッカーがあれば push しない
/pr-check feature/foo → main。flow-14 の 9 カテゴリを [x]/[ ]公式ワークフロー早見（2026-02）
一次情報のセクションと本サイトの対応。
| 公式テーマ | 要点 | 本サイト |
|---|---|---|
| ハーネス | Instructions + Tools + Model | Rules / Skills / Plan |
| Plan first | Shift+Tab · Save to .cursor/plans/ | ズレたら計画からやり直す |
| コンテキスト | 総 @ 不要 · @Branch · @Past Chats | Past Chats 手順 |
| TDD | テスト先行 → 実装 → 反復 | エージェント TDD 5 ステップ |
| レビュー | diff 監視 · Agent Review · Bugbot | 提出前 AI レビュー |
| 並列 | worktree · 複数モデル比較 | worktree / 多模型 |
| クラウド | Background / cursor.com/agents | Cloud · ビジュアル |
| 画像 | スクショ · Figma MCP · Browser サイドバー | ビジュアルデバッグ |
公式対応と応用
公式 BP → 本リポの対応（一覧）
| 公式 | ここでやること |
|---|---|
| Plan first | A. Plan → Build |
| コンテキスト | Past Chats · @Branch |
| Commands | 16 選 |
| レビュー | /review · Bugbot（PR） |
| 並列 | worktree / Task |
手順: Rule / Skill / Command の追加
| 追加したいもの | 置き場 | 手順 |
|---|---|---|
| 毎回守る下限 | .cursor/rules/*.mdc | frontmatter に alwaysApply: true → 本文は 20 行以内 → サンプル |
| 週次の多段手順 | .cursor/skills/name/SKILL.md | description を命令形で → サンプル |
| 毎日の 1 ショット | .cursor/commands/foo.md | ファイル名 = /foo · $ARGUMENTS 対応 |
---
description: ドメイン不変条件
alwaysApply: true
---
# ドメイン
- 在庫は 0 以上（物理削除禁止）
手順: @Past Chats（前の会話を参照）
flowchart TD
newChat[新規Composerを開く] --> pastChats[Past Chatsで1件選ぶ]
pastChats --> goalLine[ゴールを1から3行書く]
goalLine --> attachFiles[todo.mdとdocsを添付]
attachFiles --> agentAsk[AIに依頼]
| 状況 | 操作 |
|---|---|
| 同じバグの続き | 同一会話を継続 |
| 別 PR / 別機能 | 新規 + Past Chats 1 件 + todo |
| 差分レビュー | @Branch を追加 |
配置ツリー（Cursor・併用）
project/
├── AGENTS.md
├── tasks/todo.md
├── docs/invoice-export/
├── .cursor/
│ ├── rules/00-project.mdc
│ ├── commands/plan.md
│ ├── skills/pr-review/SKILL.md
│ └── plans/20260530-feature.md
├── .claude/skills/ # Claude 併用時
└── .agents/skills/ # Codex 併用時