Skill عملی برای AI Agent

Diagnose

برای تشخیص مسئله قبل از تغییر کد و جلوگیری از fixهای حدسی استفاده می‌شود.

آمادهدیباگمتوسطبه‌روزرسانی ۱۶ تیر ۱۴۰۵
1

این Skill چه کاری می‌کند؟

این Skill به شما کمک می‌کند مشکل را با کمک AI Agent سریع‌تر و دقیق‌تر تشخیص دهید. کافی است نشانه خطا، محل وقوع و تغییرهای اخیر را به Agent بدهید تا فرضیه‌های محتمل، شواهد لازم و مسیر بررسی دریافت کنید. این Skill برای توسعه‌دهندگانی مناسب است که می‌خواهند قبل از هر تغییر، علت را پیدا کنند.

2

ورودی لازم

  • نشانه خطا
  • محل وقوع
  • تغییر اخیر
  • آنچه قبلا تست شده
3

خروجی نهایی

  • فرضیه‌های محتمل
  • گام‌های بررسی
  • شواهد لازم
  • مسیر رفع مشکل
4

مناسب کدام Agentهاست؟

Claude CodeCursorCodexGeminiChatGPT
5

Copy Prompt / Workflow

قبل از تغییر کد، مسئله را تشخیص بده. ورودی: نشانه خطا، محل وقوع و تغییرهای اخیر. خروجی: فرضیه‌ها، شواهد لازم و ترتیب بررسی.
6

آموزش استفاده مرحله‌ای

  1. نشانه خطا را دقیق بنویس.
  2. از Skill بخواه علت‌های محتمل را رتبه‌بندی کند.
  3. هر فرضیه را با یک تست کوچک بررسی کن.
  4. بعد از پیدا شدن علت، راه‌حل را اعمال کن.
7

مثال واقعی

برای ارور hydration در Next.js، این Skill می‌تواند قبل از هر تغییر، علت‌های محتمل مثل داده متغیر یا render ناسازگار را جدا کند.
8

خطاهای رایج

  • مستقیم سراغ تغییر کد می‌روی.
  • فرضیه‌ها را بدون تست قبول می‌کنی.
  • نشانه خطا را به تیم کامل منتقل نمی‌کنی.
9

منبع و نصب Skill

منبع اصلی و تأییدشده در skills.sh

npx skills add https://github.com/mattpocock/skills --skill diagnose
10
دیباگ سیستماتیکآمادهمتوسط

Systematic Debugging

برای دیباگ مرحله‌ای بر اساس ریشه‌یابی، فرضیه‌سازی و تست استفاده می‌شود.

ورودینشانه مشکل
خروجیفرضیه‌های مرتب‌شده
Compatible Agents
Claude CodeCursorCodexGeminiChatGPT
خروجی نهایی

فرضیه‌های مرتب‌شده · تست‌های کوچک · علت ریشه‌ای · راه‌حل تاییدشده

تست و توسعهآمادهمتوسط

TDD

برای اجرای توسعه تست‌محور با Agent و کاهش باگ قبل از نوشتن کد اصلی استفاده می‌شود.

ورودیرفتار مورد انتظار
خروجیتست fail اولیه
Compatible Agents
Claude CodeCursorCodexGitHub CopilotGemini
خروجی نهایی

تست fail اولیه · کد minimal برای pass · مراحل refactor · سناریوهای edge case

QA / Verificationآمادهساده

Verification Before Completion

برای چک نهایی قبل از اعلام اتمام کار توسط Agent استفاده می‌شود.

ورودیکار انجام‌شده
خروجیچک‌لیست تایید
Compatible Agents
Claude CodeCursorCodexGeminiChatGPT
خروجی نهایی

چک‌لیست تایید · موارد ناقص · خطاهای احتمالی · مرحله بعدی