Community研究&データ分析github.com

yaolifeng0629/ylf-agent-skills

規律的なコーディング作業と永続的なプロジェクト指示のためのYLFエージェントスキル

ylf-agent-skills とは?

このスキルは、AIエージェント(例:Claude Code、Cursor、Codex)が規律を持ってコードタスクを実行し、プロジェクト固有の指示を永続的に保持するためのフレームワークを提供します。「完了」の定義から始まり、プロジェクトへの適応、必要な場合のみの確認、最小限の変更(外科的変更)、実際の検証、安全境界の維持、そして簡潔な報告まで、7つの明確なプロセスステップで構成されています。各ステップは、エージェントが自律的に効率よく、かつ安全に作業を進めるための具体的なガイドラインを示しています。特に、プロジェクトルール(AGENTS.mdやCLAUDE.mdなど)を優先し、このスキルは作業方法のギャップを埋めるためのものであると明記されている点が特徴です。また、永続的なプロジェクト指示には別途 `ylf-project-instructions` を使用することが推奨されており、スキル自体は現在のタスク専用の短い内容に保たれています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add yaolifeng0629/ylf-agent-skills

Installed? Explore more 研究&データ分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

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

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

ドキュメント

YLFコーディング規約

これは現在のタスクのみに使用してください。これらの規約をプロジェクトで永続的にするには、ylf-project-instructions を使用してください。

このスキルは意図的に短くしています。すべてのプロジェクトルールをこのファイルに詰め込むのではなく、現在のプロジェクトを読んで適応してください。

プロセス

  1. 完了を定義する。

    • 具体的な成果と、それをどのように検証するかを明示します。
    • 重要な作業の場合は、簡潔なチェックリストを作成し、作業を進めながら更新します。
    • 完了とは、要求された結果が動作し、可能な限り検証され、明確に報告された状態を意味します。
  2. プロジェクトに適応する。

    • まず、アクティブなプロジェクトの指示を読みます:AGENTS.md、CLAUDE.md、READMEファイル、パッケージスクリプト、テスト設定、および近くのコード。
    • プロジェクトルールはこのスキルよりも優先されます。このスキルは、作業方法のギャップを埋めます。
    • 既存のパターン、依存関係、命名規則、ファイルレイアウト、および検証コマンドに従います。
    • それが通常の解決策である場合、カスタム実装よりも、成熟したプロジェクト依存関係または適切にメンテナンスされたオープンソースパッケージを優先します。
  3. 重要な場合にのみ明確にする。

    • タスクが明確でリスクが低い場合は、先に進みます。
    • アーキテクチャ、データ構造、外部サービス、破壊的なアクション、大規模なリファクタリング、または曖昧な範囲など、影響の大きい選択の前には立ち止まって質問します。
    • 質問するときは、推奨する回答とトレードオフを示します。
  4. 外科的に変更する。

    • 要求を満たす最小の変更を行います。
    • タスクで必要とされない限り、隣接するコードのリファクタリング、再フォーマット、名前変更、またはクリーンアップは行いません。
    • 自身の変更によって作成された未使用のコードのみを削除します。
    • 修正が無関係なファイルに波及し始めた場合は、続行する前に停止し、その境界を説明します。
  5. 実際に検証する。

    • バグ:可能な場合はまず再現し、その後修正を証明します。
    • スクリプト:代表的な入力を使用して実行し、出力を検査します。
    • Web/UI:ページを開き、レンダリングを確認し、変更したフローを実行します。
    • デプロイメントと統合:アクセスが存在する場合は、ライブサービスまたはコントロールプレーンを確認します。
    • 既存の環境ノイズによって完全な検証が妨げられている場合は、要求された結果を証明する最も狭いチェックを実行し、未検証のまま残っているものを伝えます。
  6. 安全境界を維持する。

    • ユーザーが明示的に要求しない限り、gitアクションを実行しないでください。
    • ファイルまたはディレクトリをバッチ削除しないでください。一度に削除するのは、明示的な単一ファイルパスのみです。一括削除が必要な場合は、停止してユーザーに処理を依頼してください。
    • シークレットを公開しないでください。シークレットが存在することや、名前が一致することを確認することは問題ありません。
    • Windowsでは、ファイルロック、pnpmのno-TTY問題、古いビルドアーティファクトなどの環境ノイズを、変更の正しさから分離します。
  7. 簡潔に報告する。

    • 何を変更したか、結果は何か、何を検証したかをユーザーに伝えます。
    • 本当に未解決の項目のみに言及します。
    • ユーザーが要求しない限り、最終報告書に実装の詳細を含めないでください。

整理

このスキルを更新する際は、動作を変更するルールのみを保持してください。長い例、ツールのチュートリアル、プロジェクト固有の事実は削除してください。これらはプロジェクトの指示または別のスキルに属します。

関連スキル