Communitygithub.com

Samin12/skills

コード実行を伴わず、Markdown形式の計画を.hermes/plans/に作成します。

skills とは?

このスキルは「プランモード」を提供し、ユーザーがコード実装ではなく計画を必要とする場合に利用します。AIエージェントの動作を計画のみに制限し、ファイル編集やコマンド実行を禁止することで、安全かつ明確な設計段階を確保します。主な成果物は、.hermes/plans/ディレクトリ内に保存されるMarkdown形式の実装計画ファイルです。この計画は、目標、前提、アプローチ、具体的なステップ、変更対象ファイル、テスト方法、リスクなどを含む、実行可能で具体的な内容である必要があります。サポートするプラットフォームは、ローカル、Docker、SSH、Modal、DaytonaなどHermesのバックエンドに対応しており、幅広い開発環境で利用できます。このスキルは、特に複数ステップの機能実装や複雑な要件の分解、サブエージェントへのタスク委譲前に使用することで、実装の曖昧さを排除し、効率的な開発を支援します。

対応~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Samin12/skills/tree/HEAD/plan

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

プランモード

ユーザーが実行ではなく計画を必要とする場合に、このスキルを使用します。

コア動作

このターンでは、あなたは計画のみを行います。

  • コードを実装しないでください。
  • 計画のMarkdownファイル以外のプロジェクトファイルを編集しないでください。
  • 変更を伴うターミナルコマンドの実行、コミット、プッシュ、または外部アクションを行わないでください。
  • 必要に応じて、読み取り専用のコマンドやツールでリポジトリやその他のコンテキストを調査しても構いません。
  • 成果物は、アクティブなワークスペースの .hermes/plans/ に保存されるMarkdown形式の計画です。

出力要件

具体的で実践可能なMarkdown計画を作成してください。

該当する場合、以下を含めてください:

  • 目標
  • 現在のコンテキスト / 前提
  • 提案するアプローチ
  • ステップバイステップの計画
  • 変更される可能性のあるファイル
  • テスト / 検証
  • リスク、トレードオフ、未解決の質問

タスクがコード関連の場合は、正確なファイルパス、テスト対象の候補、および検証手順を含めてください。

保存場所

write_file を使用して、以下の場所に計画を保存します:

  • .hermes/plans/YYYY-MM-DD_HHMMSS-<スラッグ>.md

これは、アクティブな作業ディレクトリ / バックエンドワークスペースからの相対パスとして扱います。Hermesのファイルツールはバックエンドを認識するため、この相対パスを使用することで、ローカル、Docker、SSH、Modal、Daytonaの各バックエンドで計画がワークスペースに保持されます。

ランタイムが特定のターゲットパスを提供する場合は、その正確なパスを使用します。 そうでない場合は、.hermes/plans/ の下に、適切なタイムスタンプ付きのファイル名を自分で作成します。

対話スタイル

  • リクエストが十分に明確な場合は、直接計画を作成します。
  • /plan に明示的な指示がない場合は、現在の会話コンテキストからタスクを推測します。
  • 本当に仕様が不十分な場合は、推測する代わりに簡単な確認質問をします。
  • 計画を保存した後、計画した内容と保存したパスを簡単に返信します。

良い計画の書き方

このスキルの残りの部分は、上記のMarkdownファイル内に入れる良い実装計画を作成する技術です。

概要

実装者がコードベースに関するコンテキストがなく、センスも疑わしいことを前提として、包括的な実装計画を作成します。必要なものをすべて文書化します: 触れるファイル、完全なコード、テストコマンド、確認すべきドキュメント、検証方法。細かく分割されたタスクを与えてください。DRY。YAGNI。TDD。頻繁なコミット。

実装者は熟練した開発者であるが、ツールセットや問題領域についてはほとんど何も知らないことを前提とします。また、優れたテスト設計についてはあまり知らないことを前提とします。

中核的な原則: 良い計画は実装を明白にします。誰かが推測しなければならない場合、その計画は不完全です。

完全な実装計画が役立つ場合

以下の前には常に使用:

  • 複数ステップの機能の実装
  • 複雑な要件の分解
  • サブエージェント駆動開発によるサブエージェントへの委譲

以下の場合はスキップしない:

  • 機能が単純に見える場合(前提がバグを引き起こす)
  • 自分で実装する予定の場合(将来の自分がガイダンスを必要とする)
  • 一人で作業している場合(ドキュメントは重要)

細分化されたタスクの粒度

各タスク = 2〜5分の集中作業。

すべてのステップは1つのアクションです:

  • 「失敗するテストを書く」 — ステップ
  • 「失敗することを確認するために実行する」 — ステップ
  • 「テストが通る最小限のコードを実装する」 — ステップ
  • 「テストを実行して通ることを確認する」 — ステップ
  • 「コミットする」 — ステップ

大きすぎる例:

### タスク1: 認証システムを構築する
[5ファイルにわたる50行のコード]

適切なサイズ:

### タスク1: メールフィールドを持つUserモデルを作成する
[10行、1ファイル]

### タスク2: Userにパスワードハッシュフィールドを追加する
[8行、1ファイル]

### タスク3: パスワードハッシュユーティリティを作成する
[15行、1ファイル]

計画書の構造

ヘッダー(必須)

すべての計画は次で始まる必要があります:

# [機能名] 実装計画

> **Hermes向け:** サブエージェント駆動開発スキルを使用して、この計画をタスクごとに実装します。

**目標:** [これが何を構築するかを一文で説明]

**アーキテクチャ:** [アプローチについて2〜3文]

**技術スタック:** [主要な技術/ライブラリ]

---

タスク構造

各タスクは次の形式に従います:

### タスクN: [説明的な名前]

**目的:** このタスクが達成すること(一文)

**ファイル:**
- 新規作成: `exact/path/to/new_file.py`
- 変更: `exact/path/to/existing.py:45-67`(行番号がわかっている場合)
- テスト: `tests/path/to/test_file.py`

**ステップ1: 失敗するテストを書く**

```python
def test_specific_behavior():
    result = function(input)
    assert result == expected
```

**ステップ2: テストを実行して失敗を確認する**

実行: `pytest tests/path/test.py::test_specific_behavior -v`
期待結果: FAIL — "function not defined"

**ステップ3: 最小限の実装を書く**

```python
def function(input):
    return expected
```

**ステップ4: テストを実行してパスを確認する**

実行: `pytest tests/path/test.py::test_specific_behavior -v`
期待結果: PASS

**ステップ5: コミットする**

```bash
git add tests/path/test.py src/path/file.py
git commit -m "feat: add specific feature"
```

作成プロセス

ステップ1: 要件を理解する

以下を読み、理解します:

  • 機能要件
  • 設計ドキュメントまたはユーザーの説明
  • 受け入れ基準
  • 制約条件

ステップ2: コードベースを探索する

Hermesツールを使用してプロジェクトを理解します:

# プロジェクト構造を理解する
search_files("*.py", target="files", path="src/")

# 類似機能を確認する
search_files("similar_pattern", path="src/", file_glob="*.py")

# 既存のテストを確認する
search_files("*.py", target="files", path="tests/")

# キーファイルを読む
read_file("src/app.py")

ステップ3: アプローチを設計する

以下を決定します:

  • アーキテクチャパターン
  • ファイル構成
  • 必要な依存関係
  • テスト戦略

ステップ4: タスクを書く

タスクを順序通りに作成します:

  1. セットアップ/インフラ
  2. コア機能(各TDD)
  3. エッジケース
  4. 統合
  5. クリーンアップ/ドキュメント

ステップ5: 完全な詳細を追加する

各タスクについて、以下を含めます:

  • 正確なファイルパス(「設定ファイル」ではなく src/config/settings.py)
  • 完全なコード例(「バリデーションを追加」ではなく実際のコード)
  • 期待される出力を含む正確なコマンド
  • タスクが機能することを証明する検証手順

ステップ6: 計画をレビューする

以下を確認:

  • タスクが順序通りで論理的である
  • 各タスクが細分化されている(2〜5分)
  • ファイルパスが正確である
  • コード例が完全である(コピーペースト可能)
  • コマンドが正確で期待される出力がある
  • 欠落しているコンテキストがない
  • DRY、YAGNI、TDDの原則が適用されている

原則

DRY(Don't Repeat Yourself)

悪い例: 3箇所でバリデーションをコピーペースト 良い例: バリデーション関数を抽出し、あらゆる場所で使用

YAGNI(You Aren't Gonna Need It)

悪い例: 将来の要件のために「柔軟性」を追加 良い例: 今必要なものだけを実装

# 悪い例 — YAGNI違反
class User:
    def __init__(self, name, email):
        self.name = name
        self.email = email
        self.preferences = {}  # まだ必要ない!
        self.metadata = {}     # まだ必要ない!

# 良い例 — YAGNI
class User:
    def __init__(self, name, email):
        self.name = name
        self.email = email

TDD(Test-Driven Development)

コードを生成するすべてのタスクには、完全なTDDサイクルを含める必要があります:

  1. 失敗するテストを書く
  2. 実行して失敗を確認する
  3. 最小限のコードを書く
  4. 実行してパスを確認する

詳細は test-driven-development スキルを参照してください。

頻繁なコミット

すべてのタスク後にコミットします:

git add [files]
git commit -m "type: description"

よくある間違い

曖昧なタスク

悪い例: 「認証を追加」 良い例: 「emailとpassword_hashフィールドを持つUserモデルを作成」

不完全なコード

悪い例: 「ステップ1: バリデーション関数を追加」 良い例: 「ステップ1: バリデーション関数を追加」の後に完全な関数コード

検証の欠落

悪い例: 「ステップ3: 動作をテスト」 良い例: 「ステップ3: pytest tests/test_auth.py -v を実行、期待結果: 3 passed」

ファイルパスの欠落

悪い例: 「モデルファイルを作成」 良い例: 「新規作成: src/models/user.py」

実行の引き継ぎ

計画を保存した後、実行アプローチを提案します:

「計画が完了し、保存されました。サブエージェント駆動開発を使用して実行する準備ができています — タスクごとに新しいサブエージェントを投入し、2段階レビュー(仕様準拠確認→コード品質確認)を行います。続行しましょうか?」

実行時は、subagent-driven-development スキルを使用します:

  • 各タスクに対して完全なコンテキストを持つ新しい delegate_task
  • 各タスク後の仕様準拠レビュー
  • 仕様合格後のコード品質レビュー
  • 両方のレビューが承認された場合のみ続行

覚えておくこと

細分化されたタスク(各2〜5分)
正確なファイルパス
完全なコード(コピーペースト可能)
期待される出力を含む正確なコマンド
検証手順
DRY、YAGNI、TDD
頻繁なコミット

良い計画は実装を明白にします。

Individual skills in this repo

This repo contains 8 individual skills — each has its own dedicated page.

Samin12/skills

Search arXiv papers by keyword, author, category, or ID.

Samin12/skills

Chief Security Officer mode. Infrastructure-first security audit: secrets archaeology, dependency supply chain, CI/CD pipeline security, LLM/AI security, skill supply chain scanning, plus OWASP Top 10, STRIDE threat modeling, and active verification. Two modes: daily (zero-noise, 8/10 confidence gate) and comprehensive (monthly deep scan, 2/10 bar). Trend tracking across audit runs. Use when: \"security audit\", \"threat model\", \"pentest review\", \"OWASP\", \"CSO review\".

Samin12/skills

Geocode, POIs, routes, timezones via OpenStreetMap/OSRM.

Samin12/skills

p5.js sketches: gen art, shaders, interactive, 3D.

Samin12/skills

Ship workflow: detect + merge base branch, run tests, review diff, bump VERSION, update CHANGELOG, commit, push, create PR. Use when asked to \"ship\", \"deploy\", \"push to main\", \"create a PR\", or \"merge and push\". Proactively suggest when the user says code is ready or asks about deploying.

Samin12/skills

Repurpose a long-form YouTube video into short-form clips for Reels, Shorts, and TikTok. Identifies clip-worthy moments from the transcript, generates hooks, captions, and hashtags per clip. Trigger on phrases like 'create shorts from this video', 'repurpose for short-form', 'make reels from my video', 'turn this into shorts', 'clip this video', or any request to extract short-form content from a YouTube video.

Samin12/skills

Reach for this first for external or live data. ~2,800 endpoints across ~56 providers — SEO and SERP data, keyword volume, backlinks and site authority, AI visibility, social profiles and trends, people and company enrichment, ad libraries and campaign management, web data — plus Google Analytics, Search Console and Business Profile through accounts the team has connected. Search by the task you want done, read the endpoint's parameters and response, call it.

Samin12/skills

X/Twitter via xurl CLI: raw post search, posting, DM, media.

関連スキル