home / skills / chachamaru127 / claude-code-harness / vibecoder-guide

vibecoder-guide skill

/skills/vibecoder-guide

This skill guides non-technical users through VibeCoder in natural language, answering next steps and usage questions to keep development moving.

npx playbooks add skill chachamaru127/claude-code-harness --skill vibecoder-guide

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
4.6 KB
---
name: vibecoder-guide
description: "VibeCoder(非技術ユーザー)を自然言語開発でガイド。Use when user asks what to do next, how to use the system, needs help, or is stuck. Do NOT load for: technical-user work, direct implementation requests, or reviews."
description-en: "Guides VibeCoder (non-technical users) through natural language development. Use when user asks what to do next, how to use the system, needs help, or is stuck. Do NOT load for: technical-user work, direct implementation requests, or reviews."
description-ja: "VibeCoder(非技術ユーザー)を自然言語開発でガイド。Use when user asks what to do next, how to use the system, needs help, or is stuck. Do NOT load for: technical-user work, direct implementation requests, or reviews."
allowed-tools: ["Read"]
user-invocable: false
---

# VibeCoder Guide Skill

VibeCoder(非技術者)が自然言語だけで開発を進められるようガイドするスキル。
「どうすればいい?」「次は何?」などの質問に自動で応答します。

---

## トリガーフレーズ

このスキルは以下のフレーズで自動起動します:

- 「どうすればいい?」「どうしたらいい?」
- 「次は何をすればいい?」「次は?」
- 「何ができる?」「何をすればいい?」
- 「困った」「わからない」「助けて」
- 「使い方を教えて」
- "what should I do?", "what's next?", "help"

---

## 概要

VibeCoder は技術的なコマンドやワークフローを知らなくても、
自然な日本語で質問するだけで次のアクションが分かります。

---

## 応答パターン

### パターン1: プロジェクトがない場合

> 🎯 **まずはプロジェクトを始めましょう!**
>
> **言い方の例:**
> - 「ブログを作りたい」
> - 「タスク管理アプリを作りたい」
> - 「ポートフォリオサイトを作りたい」
>
> ざっくりで大丈夫です。やりたいことを教えてください。

### パターン2: Plans.md があるが進行中タスクがない

> 📋 **計画があります。作業を始めましょう!**
>
> **現在の計画:**
> - フェーズ1: 基盤構築
> - フェーズ2: コア機能
> - ...
>
> **言い方の例:**
> - 「フェーズ1を始めて」
> - 「最初のタスクをやって」
> - 「全部やって」

### パターン3: タスク進行中

> 🔧 **作業中です**
>
> **現在のタスク:** {{タスク名}}
> **進捗:** {{完了数}}/{{全体数}}
>
> **言い方の例:**
> - 「続けて」
> - 「次のタスク」
> - 「今どこまで進んだ?」

### パターン4: フェーズ完了後

> ✅ **フェーズが完了しました!**
>
> **次にできること:**
> - 「動作確認して」→ 開発サーバーを起動
> - 「レビューして」→ コード品質チェック
> - 「次のフェーズへ」→ 次の作業を開始
> - 「コミットして」→ 変更を保存

### パターン5: エラー発生時

> ⚠️ **問題が発生しました**
>
> **状況:** {{エラーの要約}}
>
> **言い方の例:**
> - 「直して」→ 自動修正を試行
> - 「説明して」→ 問題の詳細を説明
> - 「スキップして」→ 次のタスクへ

---

## よく使うフレーズ対応表

| やりたいこと | 言い方 |
|-------------|--------|
| プロジェクト開始 | 「〇〇を作りたい」 |
| 計画を見たい | 「計画を見せて」「今の状況は?」 |
| 作業を開始 | 「始めて」「作って」「フェーズ1をやって」 |
| 続きをやる | 「続けて」「次」 |
| 動作確認 | 「動かして」「見せて」 |
| コード確認 | 「レビューして」「チェックして」 |
| 保存する | 「コミットして」「保存して」 |
| 困った時 | 「どうすればいい?」「助けて」 |
| 全部任せる | 「全部やって」「おまかせ」 |

---

## コンテキスト判定

このスキルは以下を確認して適切な応答を選択:

1. **AGENTS.md の存在** → プロジェクトが初期化済みか
2. **Plans.md の内容** → 計画があるか、進捗状況
3. **現在のタスク状態** → `cc:WIP` マーカーの有無
4. **直近のエラー** → 問題が発生しているか

---

## 実装ノート

このスキルが起動したら:

1. 現在の状態を分析
2. 適切なパターンを選択
3. 具体的な「言い方の例」を提示
4. ユーザーの次のアクションを待つ

**重要**: 技術用語を避け、平易な日本語で説明する

Overview

This skill guides non-technical VibeCoder users to move a project forward using only natural language. It answers questions like "what should I do next?" or "help" and suggests clear next actions without technical jargon. It does not handle direct implementation, code reviews, or advanced technical work for developer users.

How this skill works

I analyze the current project context (presence of agent/config files, an existing plan, active tasks, and any recent errors) and map that state to one of several response patterns. For each pattern I provide brief, actionable phrases the user can say to advance the project, start tasks, request checks, or recover from errors. I then wait for the user's choice and guide the next step conversationally.

When to use it

  • You are a non-technical user wondering what to do next in your project.
  • You need simple, natural-language prompts to start or continue work.
  • You are stuck or see an unclear message and need next steps.
  • You want to move through high-level phases without developer commands.
  • You need help choosing between testing, reviewing, or moving to the next phase.

Best practices

  • Describe your goal briefly (e.g., "I want a blog") so I can suggest a starting project.
  • Use short natural phrases from the suggested examples to trigger the right action.
  • Ask for clarification if a suggested next step is unclear or you see an error.
  • Avoid requesting direct code implementation or technical reviews—those are for developer tools.
  • When an error occurs, tell me whether you want an explanation, an automatic fix attempt, or to skip the task.

Example use cases

  • You have no project yet: say "I want to make a portfolio" and get a suggested starter step.
  • Plans exist but no active task: say "start phase 1" to begin the first tasks.
  • A task is in progress: say "continue" or "what's next?" to get the current status and next action.
  • A phase just finished: say "run checks" or "move to next phase" to proceed.
  • An error appeared: say "explain" to get a plain-language summary or "fix it" to try an automatic repair.

FAQ

Can this skill write or review code for me?

No. This skill provides non-technical guidance and next steps. It does not perform developer-level implementation or in-depth code reviews.

What should I say to start a project?

Give a simple goal like "I want to build a task app" or "create a blog" and I will suggest the first steps.