remember

会話を振り返り、価値のある知識を記録してください。特に、話し合ったり発見したりしたベストプラクティスを重視してください。これらが最も重要な保存対象です。

ステップ 1：ベストプラクティスと重要な学びを特定する

会話を確認し、次の内容を探してください。

ベストプラクティス（最優先）

• 効果があったパターン - 有効だとわかったアプローチ、手法、ソリューション
• 避けるべきアンチパターン - 問題を引き起こしたミス、注意点、アプローチ
• 品質基準 - 優れたコード、ドキュメント、プロセスの基準
• 判断の根拠 - あるアプローチを別のアプローチより選んだ理由

その他の価値ある知識

• コーディング規約とスタイルの好み
• プロジェクトのアーキテクチャに関する決定
• 策定したワークフローとプロセス
• 記憶しておく価値のあるツール、ライブラリ、手法
• あなたの振る舞いや出力に対して私が伝えたフィードバック

ステップ 2：各学びの保存先を決める

ベストプラクティスや学びごとに、適切な保存先を選んでください。

-> 記憶（AGENTS.md）：好みやガイドライン

次のような知識は記憶に保存します。

• 複数ステップの手順ではなく、好みやガイドラインである
• 常に意識しておくべきことである
• 単純なルールやパターンである

グローバル（$DEEPAGENTS_HOME/agent/AGENTS.md）：すべてのプロジェクトに適用される全般的な好み プロジェクト（.deepagents/AGENTS.md）：プロジェクト固有の規約や決定事項

-> スキル：再利用可能なワークフローと方法論

次のような内容を策定した場合は、スキルを作成します。

• 再利用する価値のある複数ステップのプロセス
• 特定の種類のタスクに関する方法論
• ベストプラクティスを組み込んだワークフロー
• 一貫して実行すべき手順

スキルは、単に「何を」覚えておくかだけでなく、「どのように」適切に実行するかも記述できるため、記憶項目より強力です。

ステップ 3：重要なベストプラクティスをスキルとして作成する

ワークフローやプロセスについてベストプラクティスを策定した場合は、それをスキルにまとめてください。

例： コードレビューのベストプラクティスについて話し合った場合は、それを再利用可能なワークフローとしてまとめた code-review スキルを作成します。

スキルの保存先

$DEEPAGENTS_HOME/agent/skills/<skill-name>/SKILL.md

スキルの構成

skill-name/
├── SKILL.md          (required - main instructions with best practices)
├── scripts/          (optional - executable code)
├── references/       (optional - detailed documentation)
└── assets/           (optional - templates, examples)

SKILL.md の形式

---
name: skill-name
description: "What this skill does AND when to use it. Include triggers like 'when the user asks to X' or 'when working with Y'. This description determines when the skill activates."
---

# Skill Name

## Overview
Brief explanation of what this skill accomplishes.

## Best Practices
Capture the key best practices upfront:
- Best practice 1: explanation
- Best practice 2: explanation

## Process
Step-by-step instructions (imperative form):
1. First, do X
2. Then, do Y
3. Finally, do Z

## Common Pitfalls
- Pitfall to avoid and why
- Another anti-pattern we discovered

重要な原則

1. ベストプラクティスを目立つ位置に記載する - ワークフロー全体の指針となるよう、上部に配置してください
2. 簡潔さを重視する - 自明でない知識だけを記載してください。すべての段落に、トークンを費やすだけの価値が必要です
3. 明確な適用条件を設ける - スキルがいつ有効になるかは説明によって決まります。具体的に記述してください
4. 命令形で書く - 「ファイルを作成する」のように指示してください。「ファイルを作成してください」は避けてください
5. アンチパターンを含める - 何をすべきでないかは、何をすべきかと同じくらい価値のある情報です

ステップ 4：簡単な学びを記憶に追加する

スキルにするほどではない好み、ガイドライン、単純なルールは、次の方法で記録してください。

## Best Practices
- When doing X, always Y because Z
- Avoid A because it leads to B

既存のファイルを更新するには edit_file を、新しいファイルを作成するには write_file を使用してください。

ステップ 5：変更内容を要約する

記録した内容と保存先を一覧にしてください。

• 作成したスキル（組み込んだ主なベストプラクティスを記載）
• 追加した記憶項目（保存先を記載）