skill-archetypes

スキルの類型

最適な類型を選び、その構成に従ってください。

1. CLI リファレンススキル

ツール、CLI、API 向けです。操作ごとに構成し、説明文は最小限にします。

## Authentication
[How to authenticate]

## Core Operations
| Command | Description |
|---------|-------------|
| `tool init` | Initialize project |
| `tool run` | Execute task |

## Common Workflows
[Task-oriented examples]

例： kamal-coder、wrangler-coder、gh-cli

2. 方法論スキル

開発手法、ワークフロー、理念向けです。

## Core Philosophy
[Why this approach matters - 2-3 sentences max]

## The Process
1. [Step with criteria]
2. [Step with criteria]

## Decision Criteria
| Situation | Action |
|-----------|--------|
| [condition] | [response] |

例： tdd-workflow、dhh-coder、founder-mode

3. 安全性／セキュリティスキル

リスクを伴う操作向けです。段階的な承認を含めます。

## Risk Tiers

| Tier | Operations | Approval |
|------|------------|----------|
| Low | Read-only queries | Auto |
| Medium | Modifications | Confirm |
| High | Destructive ops | Explicit |

## Blocking Patterns
[What to never do]

## Allowing Patterns
[Safe operations]

例： infra-security-review、devops-verifier

4. オーケストレーションスキル

他のツールを連携させる複数ステップのプロセス向けです。

## Quick Start
[Minimal invocation]

## Workflow Phases
1. [Phase]: [What happens]
2. [Phase]: [What happens]

## Machine-Readable Output
[JSON/YAML schema for automation]

例： build-task-workflow、quality-gate

高度なパターン

THE EXACT PROMPT パターン

エージェント間の再現可能な引き継ぎでは、プロンプトをすべて大文字で記述します。

## THE EXACT PROMPT

ANALYZE THE FOLLOWING CODE FOR SECURITY VULNERABILITIES:
1. CHECK FOR HARDCODED SECRETS
2. IDENTIFY SQL INJECTION RISKS
3. FLAG INSECURE DEPENDENCIES

RETURN FINDINGS AS JSON WITH SEVERITY LEVELS.

チェックリストパターン

進捗を追跡する複数ステップのプロセス向けです。

## Checklist

- [ ] Step 1: [Action with success criteria]
- [ ] Step 2: [Action with success criteria]
- [ ] Step 3: [Action with success criteria]

Mark each complete before proceeding.

フィードバックループパターン

検証が必要な操作向けです。

## Validation Loop

1. Execute action
2. Verify result matches criteria
3. If FAIL: diagnose → fix → goto 1
4. If PASS: proceed to next step

Never advance without validation passing.