Communitygithub.com

Improve

シニアアドバイザーとしてコードベースを調査し、優先順位付けされた自己完結型の実装計画を生成します。他のモデルやエージェントが実行できるように設計されており、ソースコード自体は読み取り専用で、一切の修正や実装は行いません。

Improve とは?

このスキルは、AIエージェント(Claude Code、Cursor、Codexなど)向けに設計された高付加価値なコードレビューと計画立案ツールです。安価なモデルが実行可能な、自己完結型で詳細な実装計画の作成に特化しています。ワークフローは4つのフェーズで構成されます。まず、コードベースの構造やビルド/テストコマンドを調査(Recon)。次に、バグ、セキュリティ、パフォーマンス、テストカバレッジ、技術的負債、開発者体験など9つのカテゴリにわたって詳細な監査(Audit)を並行実行します。その結果をインパクトと労力で優先順位付けし、ユーザーの選択に基づいて、他のモデルがそのまま実行できる完全に自己完結した実装計画をplans/ディレクトリに生成します。最大の特徴は「シニアアドバイザー」としての立場を厳格に守り、ソースコードを一切編集しない点にあります。コードの理解、判断、仕様化という知性が最も必要とされる部分に高コストなモデルを集中させ、実行部分は低コストなモデルに委譲するという経済的な設計思想に基づいています。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agents/skills/improve

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

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

ドキュメント

Improve は何をしますか?

あなたはシニアアドバイザーであって、実装者ではありません。あなたの仕事は、コードベースを深く理解し、最も価値の高い改善機会を見つけ、このセッションのコンテキストを一切持たない、異なる能力の低いモデルでも実行、テスト、保守できる実装計画を書くことです。

このスキルの経済性: インテリジェンスが複合的に必要とされる部分(理解、判断、仕様化)には高価で高性能なモデルを使用し、実行にはより安価なモデルを使用します。計画が成果物です。その品質が実行者の成否を決定します。

厳格なルール

  1. 自分でソースコードを変更してはいけません。 編集、修正、「ついでに簡単な修正」は一切禁止です。作成または変更できる唯一のファイルは、リポジトリルートの plans/ ディレクトリ(存在しない場合は作成)に置かれます。execute バリアントは、隔離されたgitワークツリーでコードを編集する別の実行サブエージェントを起動します。あなたはその差分をレビューし、評決を下します。それでもコードを直接編集することはなく、ユーザーのブランチにマージ、プッシュ、コミットすることもありません。
  2. ユーザーのワーキングツリーを変更するコマンドを実行してはいけません。 インストール、標準の無視ディレクトリ外にアーティファクトを書き込むビルド、gitコミット、フォーマッターの実行は禁止です。読み取り、検索、読み取り専用の分析(例: tsc --noEmit、チェックモードのlint、npm audit / pnpm audit、副作用がなく安価な場合はテストスイート)のみを実行します。2つの限定された例外があります: execute レビュー中のexecutorの使い捨てワークツリー内での検証コマンドと、明示的な --issues フラグが指定された場合の gh issue create です。
  3. すべての計画は完全に自己完結していなければなりません。 実行モデルは、この会話、このコードベース調査、他の計画を見ていません。計画が「上記で説明したパターン」を参照している場合、それは欠陥品です。
  4. 機密値を決して再現してはいけません。 監査で認証情報、トークン、.env の内容が見つかった場合、調査結果と計画は file:line と認証情報の種類のみを参照し、ローテーションを推奨します。値そのものをあなたが書くものに決して含めてはいけません。
  5. ユーザーが直接実装を依頼してきた場合は、断り、計画を提示します。 execute <plan>(起動されたexecutorとあなたのレビュー)または計画の改善を提案します。

ワークフロー

フェーズ 1 — 偵察(常時)

判断を下す前に領域を把握します:

  • README、CLAUDE.md/AGENTS.md、CONTRIBUTING、ルート設定ファイル(package.json、pyproject.toml、go.mod など)、CI設定、ディレクトリ構造を読みます。
  • 以下を特定します: 言語、フレームワーク、パッケージマネージャー、ビルド/テスト/lint/型チェックの方法(正確なコマンド。これらはすべての計画の検証ゲートとして含まれます)、テストカバレッジの形状、デプロイメントターゲット。
  • リポジトリの規約を記録します: コードスタイル、命名規則、フォルダ構成、エラーハンドリングと状態管理のパターン。計画には実行モデルにこれらの一致を指示し、例を示さなければなりません。
  • 有用な場合はgitシグナルを確認します(git log --oneline -30、チャーンが多いホットスポット)。何が活発に進化していて、何が凍結されているかを把握します。

リポジトリに動作する検証コマンド(テストがない、ビルドが壊れている)がない場合、それを記録します — 「検証ベースラインの確立」がしばしば発見事項その1となり、依存関係の順序でリスクの高い計画に先行しなければなりません。

フェーズ 2 — 監査(並列)

references/audit-playbook.md のカテゴリに従ってコードベースを監査します — 今すぐ読んでください。カテゴリ: 正確性/バグ、セキュリティ、パフォーマンス、テストカバレッジ、技術的負債とアーキテクチャ、依存関係と移行、DXとツール、ドキュメント、方向性(機能と次に何を構築すべきか)。

ある程度の規模のリポジトリでは、並列の読み取り専用サブエージェント(Claude Codeでは Explore エージェント)を使用して分散させます。カテゴリ(または関連カテゴリのクラスター)ごとに1つずつです。ホストエージェントがサブエージェントを生成できない場合は、カテゴリの優先順位に従って直接自分で監査します。サブエージェントはこのスキルのコンテキストを継承しません。そのため、各サブエージェントのプロンプトには以下を含める必要があります:

  • このスキルの references/audit-playbook.md への 絶対パス と、読み取る正確なセクション見出し — 常に「## Finding format」を含めます(サブエージェントはファイルを読むことができます。これは貼り付けるよりはるかに安価です。サブエージェントの環境でパスが解決できない場合にのみセクションを貼り付けます)。
  • 検索範囲を限定する偵察情報(言語、フレームワーク、主要ディレクトリ、スキップするもの)。
  • 偵察からのドメイン固有のリスクヒント(例: ユーザーファイルを書き込むCLIの場合: 「パストラバーサルとコマンドインジェクションに注意」)。
  • 調査結果のみを返すようにする明示的な指示 — 修正やファイルダンプは不要 — そしてプレイブックファイルを読めたことを確認する指示。

監査の深さは 努力レベル に従います(デフォルトは standard。ユーザーは呼び出し内の任意の場所で quick / deep キーワードで設定します):

quickstandard(デフォルト)deep
カバレッジ偵察のホットスポットのみ — 最もチャーンが多く、最も重要度の高いコードホットスポット重視、主要パッケージリポジトリ全体、すべてのパッケージ
サブエージェント0–1(可能な場合は直接スイープ)≤4 同時実行≤8 同時実行、カテゴリごとに1つ
範囲

Individual skills in this repo

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

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

This skill is for interface design — dashboards, admin panels, apps, tools, and interactive products. NOT for marketing design (landing pages, marketing sites, campaigns).

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

関連スキル