فهرست مطالب
اگر با ایجنتهای کدنویسی کار کرده باشید، این الگو را حتماً دیدهاید: چند جمله توضیح میدهید، ایجنت بدون هیچ سؤالی شروع به نوشتن کد میکند، وسط راه مسیر را گم میکند و آخر سر میگوید «تمام شد» بیآنکه تستی اجرا کرده باشد. Superpowers دقیقاً برای همین ساخته شده است. این ابزار یک متدولوژی کامل توسعهٔ نرمافزار است که روی مجموعهای از اسکیلهای ترکیبپذیر ساخته شده و ایجنتهایی مثل Claude Code و Codex را وادار میکند مثل یک مهندس منظم کار کنند: اول بپرسند، بعد طراحی کنند، پلن بنویسند، با تست جلو بروند و در پایان کارشان را بازبینی کنند. در این آموزش از صفر تا صد توضیح میدهیم Superpowers چیست، چطور کار میکند، چطور نصبش کنید و قبل از شروع چه نکتههایی را باید بدانید.

Superpowers چیست؟
Superpowers یک ریپوی متنباز با لایسنس MIT است که توسط Jesse Vincent و تیم Prime Radiant ساخته شده. README ریپو (و اعلان انتشار اولیهٔ آن) خودش را اینطور توصیف میکند: «یک متدولوژی کامل توسعهٔ نرمافزار برای ایجنتهای کدنویسی شما، ساختهشده روی مجموعهای از اسکیلهای ترکیبپذیر و چند دستورالعمل اولیه که مطمئن میشوند ایجنت از آنها استفاده میکند». نکتهٔ کلیدی کلمهٔ آخر است: اسکیلها بهصورت خودکار فعال میشوند. لازم نیست یاد بگیرید چه دستوری را کِی بزنید؛ ایجنت شما همینکه ببیند دارید چیزی میسازید، سراغ اسکیل مناسب میرود.
اگر هنوز با مفهوم اسکیل آشنا نیستید، اسکیل یک پوشه با یک فایل SKILL.md است که دستورالعمل کار مشخصی را به ایجنت یاد میدهد و ایجنت فقط وقتی به آن نیاز دارد بارگذاریاش میکند. در پوشهٔ skills ریپو پانزده اسکیل وجود دارد و نسخهٔ فعلی بستهٔ npm آن ۷٫۰٫۱ است.
تصویر: آیکون ریپوی رسمی Superpowers (لایسنس MIT).
مشکلی که Superpowers حل میکند
ایجنتهای کدنویسی معمولاً در سه جا خرابکاری میکنند:
بیسؤال شروع میکنند. منظور شما را حدس میزنند و با همان حدس جلو میروند. وقتی نتیجه را میبینید، متوجه میشوید چیز دیگری ساخته شده است.
پلن ندارند. کار بزرگ را یکجا انجام میدهند و وسطش مسیر را گم میکنند.
تست را دور میزنند. کد مینویسند و بدون اجرای تست اعلام میکنند که تمام شده.
Superpowers هر سه را با یک گردش کار اجباری حل میکند. فلسفهٔ آن در README چهار جمله است: تستمحور باش و همیشه اول تست بنویس؛ روشمند باش، نه ادهاک؛ پیچیدگی را کم کن و سادگی را هدف اصلی بدان؛ و شواهد را بر ادعا ترجیح بده، یعنی قبل از اعلام موفقیت راستیآزمایی کن.
گردش کار اصلی در هفت مرحله
README گردش کار پایه را در هفت مرحله توضیح میدهد. خلاصهٔ آن این است:
brainstorming (سؤال و طراحی): قبل از ساختن هر چیزی فعال میشود. با سؤالهایی که شما را به توضیح دادن وامیدارد خواستهٔ واقعیتان را بیرون میکشد و برداشتش را برای اصلاح به شما نشان میدهد. تغییرهای کوچک در همان چت توافق میشوند، اما پروژهها یک سند طراحی نوشتهشده میگیرند که سازنده بتواند از روی آن پلن بنویسد.
using-git-worktrees (فضای کاری جدا): بعد از تأیید طراحی، یک شاخهٔ جدید و یک فضای کاری ایزوله میسازد، تنظیمات پروژه را اجرا میکند و تأیید میکند که تستها از اول سالم هستند. این اسکیل اول بررسی میکند که شاید از قبل در یک فضای ایزوله باشید و فقط در صورت نبودن ابزار بومی پلتفرم، سراغ git worktree دستی میرود.
writing-plans (پلن ریز): کار را به تکههای کوچک ۲ تا ۵ دقیقهای تقسیم میکند. هر تکه مسیر دقیق فایل، کد کامل و مرحلهٔ راستیآزمایی دارد. پلن طوری نوشته میشود که حتی یک مهندس تازهکار بدون شناخت پروژه بتواند آن را دنبال کند و روی TDD، YAGNI و DRY تأکید دارد. مسیر پیشفرض ذخیرهٔ پلنها پوشهٔ docs/superpowers/plans است، مگر اینکه خودتان مسیر دیگری بخواهید.
subagent-driven-development یا executing-plans (اجرا): یا برای هر تسک یک زیرایجنت تازه میسازد و بعد از هر کدام ریویو (هم مطابقت با مشخصات و هم کیفیت کد) انجام میدهد، یا همهٔ تسکها را در همان نشست اجرا میکند و فقط در پایان یک ریویوی کلی میگیرد. حالت اول کاملترین و حالت دوم ارزانترین است.
test-driven-development (تستمحور): در طول پیادهسازی فعال است و چرخهٔ قرمز، سبز، بازآرایی را اجباری میکند: تست بنویس، شکست خوردنش را ببین، کمترین کد را بنویس، سبز شدنش را ببین و کامیت کن.
requesting-code-review (درخواست ریویو): بین تسکها کد را با پلن مقایسه میکند و مشکلها را بر اساس شدت گزارش میدهد. مشکلهای بحرانی مانع ادامه میشوند.
finishing-a-development-branch (پایان شاخه): وقتی تسکها تمام شد، تستها را راستیآزمایی میکند و گزینهها را نشان میدهد: مرج، ساخت pull request، نگه داشتن یا کنار گذاشتن شاخه، و بعد فضای کاری را تمیز میکند.
README تأکید میکند ایجنت پیش از هر کاری وجود اسکیل مرتبط را چک میکند و اینها پیشنهاد نیستند، گردش کار اجباریاند. نویسندگان میگویند گاهی ایجنت چند ساعت پشت سر هم و بدون انحراف از پلنی که با شما ساخته کار میکند.
نگاهی به چند اسکیل کلیدی
برای اینکه حس کنید این اسکیلها چه شکلی هستند، به چند نمونهٔ واقعی نگاه میکنیم.
test-driven-development
توضیح اسکیل این است: «هنگام پیادهسازی هر قابلیت یا رفع هر باگ، پیش از نوشتن کد پیادهسازی استفاده شود». اصل اصلیاش یک جمله است: اگر شکست خوردن تست را ندیده باشی، نمیدانی تستی که نوشتی چیز درستی را آزمایش میکند. اسکیل صریحاً میگوید زیر پا گذاشتن حرف قانون، زیر پا گذاشتن روح آن است؛ یعنی بهانهٔ «به روح قانون عمل کردم» پذیرفته نیست.
systematic-debugging
قانون آهنین این اسکیل این است: بدون بررسی ریشهٔ مشکل، هیچ راهحلی پیشنهاد نشود. اگر فاز اول بررسی را تمام نکردهاید، حق ندارید رفع مشکل پیشنهاد دهید. این اسکیل برای هر مشکل فنی از شکست تست تا رفتار غیرمنتظره استفاده میشود و ایجنت را از «وصلهکاری علامت» به سمت پیدا کردن علت واقعی میبرد.
verification-before-completion
قانون آهنین این اسکیل: هیچ ادعای اتمامی بدون شواهد تازهٔ راستیآزمایی. اگر دستور راستیآزمایی را در همین پیام اجرا نکردهاید، نمیتوانید بگویید تستها پاس میشوند. این همان اسکیلی است که جلوی جملهٔ «باید درست شده باشد» را میگیرد.
subagent-driven-development
برای هر تسک یک زیرایجنت تازه با زمینهٔ ایزوله میسازد تا روی کارش متمرکز بماند و زمینهٔ اصلی شما خالی نشود. بعد از هر تسک یک ریویو و در پایان یک ریویوی کلی انجام میشود. جالب است که این اسکیل اجرا را بدون توقف میخواهد و فقط چهار دلیل برای متوقف شدن میپذیرد: عملیات غیرقابلبازگشت یا مخرب، اقدام حساس از نظر امنیتی، اثر جانبی خارج از فضای کاری که طبق عرف باید قبلش پرسید (مثل مرج، پوش روی شاخهٔ مشترک یا انتشار)، و پلنی که آنقدر خراب است که هر مسیری حدس محض باشد. در بقیهٔ موارد ایجنت باید تصمیم بگیرد و تصمیمش را در یک دفتر ثبت کند.
یک نمونهٔ ساده از شروع کار با این ابزار در چت این است:
میخوام یه صفحهٔ لاگین برای پروژهام اضافه کنم.
بهجای نوشتن کد، ایجنت با اسکیل brainstorming شروع به پرسیدن میکند: چه روشهای ورودی لازم است، چه چیزی باید ذخیره شود، قوانین رمز عبور چیست. بعد طراحی را تکهتکه نشانتان میدهد تا بخوانید و تأیید کنید.
نصب Superpowers
روش نصب بسته به ابزار فرق میکند و README برای هر ابزار بخش جدا دارد. توصیهٔ README این است که اگر از چند ابزار استفاده میکنید، Superpowers را برای هر کدام جدا نصب کنید.
نصب روی Claude Code
Superpowers در بازار رسمی پلاگینهای Claude هم عرضه شده است. از آنجا یک دستور کافی است:
/plugin install superpowers@claude-plugins-official
روش دوم استفاده از بازار خود Superpowers است. ابتدا بازار را ثبت کنید:
/plugin marketplace add obra/superpowers-marketplace
و بعد پلاگین را از آن نصب کنید:
/plugin install superpowers@superpowers-marketplace
نصب روی ابزارهای دیگر
Codex (اپ و CLI): از بازار رسمی پلاگین Codex در بخش Plugins یا با دستور /plugins و جستجوی superpowers نصب میشود.
Cursor: در چت ایجنت دستور /add-plugin superpowers را بزنید یا در بازار پلاگین جستجو کنید.
Gemini CLI: با دستور gemini extensions install و آدرس ریپو نصب و با gemini extensions update بهروز میشود.
GitHub Copilot CLI، Antigravity، Devin CLI، Factory Droid، OpenCode و چند ابزار دیگر هم دستور نصب مخصوص خودشان را در README دارند. در مجموع README برای شانزده ابزار راهنمای نصب دارد.
بهروزرسانی هم بسته به ابزار فرق میکند، ولی طبق README معمولاً خودکار است.
اگر جلسه خراب شد
گاهی یک نشست بد پیش میرود: اسکیلی جایی که نباید فعال میشود، جایی که باید ساکت میماند، ایجنت پلن را نادیده میگیرد، کار را تکرار میکند یا توکن بیشتری از انتظار میسوزاند. README راهحلی دارد: از ایجنت بخواهید «بفهمد در این نشست چه چیزی با superpowers اشتباه پیش رفت». ایجنت اسکیل diagnosing-superpowers را فعال میکند، رونوشت نشست را میخواند، با شاهد خطبهخط گزارش میدهد و اگر بخواهید یک بستهٔ پاکسازیشده برای گزارش باگ میسازد. میتوانید نشست قدیمیتری را هم با شناسهاش نام ببرید.
نکات مهم و محدودیتها
ایجنت ممکن است ساعتها خودکار کار کند. پلن را قبل از اجرا با دقت بخوانید و تأیید کنید. هر چه پلن دقیقتر باشد، نتیجه قابلپیشبینیتر است.
تلهمتری اختیاری. README صریح میگوید بهصورت پیشفرض لوگوی Prime Radiant در قابلیت اختیاری visual companion اسکیل brainstorming از وبسایت سازنده بارگذاری میشود و نسخهٔ Superpowers را شامل میشود، اما جزئیاتی از پروژه، پرامپت یا ایجنت شما را نمیفرستد. برای خاموش کردن آن، متغیر محیطی SUPERPOWERS_DISABLE_TELEMETRY را روی یک مقدار درست بگذارید. این ابزار به تنظیمات DISABLE_TELEMETRY و CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC در Claude Code هم احترام میگذارد.
زمان و هزینه. گردش کار کامل با زیرایجنتها و ریویوهای مکرر توکن بیشتری از یک درخواست ساده مصرف میکند. اگر هزینه برایتان مهم است، حالت inline یعنی executing-plans ارزانتر است.
بخش تجاری جداست. خود ابزار متنباز و رایگان است، اما برای استفادهٔ سازمانی، پشتیبانی تجاری و ابزارهای اضافه از طریق Prime Radiant راه تماس وجود دارد.
پیش از نصب، فایلها را بخوانید. اسکیلها و hookها میتوانند دستور و اسکریپت اجرا کنند. نصب از بازار رسمی یا ریپوی رسمی بهترین انتخاب است.
نصب کنم یا اسکیلهای دیگر؟
Superpowers یک روش کامل و تا حدی سختگیرانه است. اگر میخواهید فقط بخشی از آن را داشته باشید، ریپوهای کوچکتر و مستقلتری هم هستند. برای مثال اگر به اجرای چند ایجنت کنار هم علاقه دارید، آموزش AgentPlane نشان میدهد چطور ایجنتهای مختلف را در یک پنل اجرا کنید و معرفی BAND یک اتاق مشترک برای آنهاست. اگر دستیار شخصی روی سیستم خودتان میخواهید، آموزش OpenClaw را ببینید. دیگر ابزارهای این حوزه را هم در بخش ابزارهای هوش مصنوعی و آموزشهای فناوری کده دنبال کنید.
یک سناریوی واقعی از ابتدا تا انتها
تصور کنید یک فروشگاه کوچک آنلاین دارید و میخواهید قابلیت «لیست علاقهمندی» اضافه کنید. بدون Superpowers احتمالاً یک جملهٔ کوتاه مینویسید و ایجنت یک جدول و چند مسیر API میسازد که شاید با ساختار پروژهٔ شما جور نباشد. با Superpowers مسیر متفاوت است. اول اسکیل brainstorming میپرسد کاربر مهمان هم میتواند علاقهمندی بسازد یا فقط کاربر واردشده، آیا لیستها عمومی هستند، حد بالای تعداد آیتم چقدر است و با محصول ناموجود چه میشود. وقتی پاسخها شفاف شد، طراحی به تکههای کوتاه نشانتان داده میشود تا هر کدام را جدا تأیید یا اصلاح کنید.
بعد از تأیید، فضای کاری ایزوله ساخته میشود تا شاخهٔ اصلی دستنخورده بماند و پایهٔ تستها سالم باشد. سپس اسکیل writing-plans پلن را به تسکهای دو تا پنج دقیقهای میشکند: ساخت مدل داده، نوشتن تستهای مسیر ایجاد، پیادهسازی مسیر، تست حالتهای خطا و اتصال به رابط کاربری. هر تسک دقیقاً میگوید کدام فایل تغییر میکند و چه تستی درستی آن را ثابت میکند. در مرحلهٔ اجرا، یک زیرایجنت تازه هر تسک را میگیرد، تست را اول مینویسد و شکستش را میبیند، کمترین کد را اضافه میکند و سبز شدنش را ثابت میکند. بعد از هر تسک ریویوی مطابقت با مشخصات و کیفیت کد انجام میشود و اگر مشکلی باشد، همانجا رفع میشود. در پایان اسکیل finishing-a-development-branch تستها را یک بار دیگر اجرا میکند و از شما میپرسد شاخه مرج شود، pull request بسازد یا کنار گذاشته شود.
نتیجهٔ این روش فقط کد نیست؛ یک ردپای قابلخواندن از تصمیمهاست: سند طراحی، پلن، تاریخچهٔ کامیتهای کوچک و گزارش ریویو. اگر چند هفته بعد بخواهید بفهمید چرا قابلیتی آنطور ساخته شد، این اسناد جواب میدهند.
اسکیلها فقط به کار برنامهنویسی نمیآیند؛ اگر کانال یوتیوب دارید، در آموزش youtube-agent-skill دیدهایم چطور با ۱۱ اسکیل رایگان Claude سناریو، عنوان و تحلیل کانال را آماده کنید.
سؤالات متداول
Superpowers چه فرقی با یک اسکیل معمولی دارد؟
یک اسکیل معمولی یک کار مشخص را یاد میدهد. Superpowers مجموعهای از اسکیلهاست که با هم یک روش کار کامل میسازند و ایجنت را وادار میکنند آن را دنبال کند.
آیا فقط روی Claude Code کار میکند؟
نه. README دستور نصب برای Claude Code، Codex، Cursor، Gemini CLI، GitHub Copilot CLI و چند ابزار دیگر دارد. فقط باید برای هر ابزار جدا نصبش کنید.
برای پروژههای کوچک هم لازم است؟
برای تغییرهای خیلی کوچک گردش کار کامل ممکن است زیاد باشد. خودِ README میگوید تغییرهای کوچک در همان چت توافق میشوند و فقط پروژههای بزرگتر سند طراحی میگیرند.
آیا کدم جایی ارسال میشود؟
طبق README، تنها دادهای که ارسال میشود نسخهٔ Superpowers هنگام بارگذاری لوگو در قابلیت اختیاری visual companion است و آن هم قابلغیرفعالسازی است. جزئیات پروژه یا پرامپت شما نمیرود.
اگر نتیجه خوب نبود چه کار کنم؟
از ایجنت بخواهید با اسکیل diagnosing-superpowers بررسی کند در نشست چه اشتباهی رخ داده است. این اسکیل با شاهد گزارش میدهد.
جمعبندی
Superpowers ایجنت کدنویسی را از یک «کدنویس عجول» به یک «همکار منظم» تبدیل میکند: اول میپرسد، بعد طراحی و پلن مینویسد، با تست پیش میرود و قبل از ادعای موفقیت شواهد میخواهد. نصبش با یک دستور انجام میشود، اما بهتر است پیش از شروع پلنها را بخوانید، از تلهمتری اختیاری آگاه باشید و هزینهٔ توکن را در نظر بگیرید. اگر دنبال اولین قدم هستید، همین امروز آن را روی یک پروژهٔ کوچک امتحان کنید و ببینید سؤالهای اسکیل brainstorming چقدر به شفاف شدن خواستهتان کمک میکند.



