ورک‌فلوهای رایج

این صفحه مجموعه‌ای از دستورالعمل‌های کوتاه برای کارهای روزمره‌ی توسعه است. برای راهنماییِ سطح‌بالاتر درباره‌ی پرامپت‌نویسی و مدیریتِ کانتکست، به بهترین شیوه‌ها سر بزن.

این صفحه پوشش می‌دهد:

دستورهای پرامپت برای کاوشِ کد، رفعِ باگ، بازنویسی، تست، PRها و مستندسازی
ازسرگیریِ گفت‌وگوهای قبلی تا یک کار بتواند در چند نشست انجام شود
اجرای نشست‌های موازی با worktreeها تا ویرایش‌های هم‌زمان با هم برخورد نکنند
برنامه‌ریزی پیش از ویرایش تا تغییرات را پیش از آن‌که روی دیسک بنشینند بررسی کنی
واگذاریِ تحقیق به ساب‌ایجنت‌ها تا کانتکستِ اصلی‌ات تمیز بماند
لوله‌کشیِ Claude به اسکریپت‌ها برای CI و پردازشِ دسته‌ای

دستورهای پرامپت

این‌ها الگوهای پرامپت برای کارهای روزمره‌اند مثل کاوشِ کدِ ناآشنا، اشکال‌زدایی، بازنویسی، نوشتنِ تست و ساختنِ PR. هرکدام در هر سطحی از Claude Code کار می‌کند؛ عبارت‌بندی را با پروژه‌ی خودت تطبیق بده.

درکِ کدبیس‌های جدید

برای پیکربندیِ Claude Code در یک monorepo یا کدبیسِ بزرگ، به Monorepoها و مخزن‌های بزرگ سر بزن.

یک مرورِ کلیِ سریع از کدبیس بگیر

فرض کن همین حالا به پروژه‌ی جدیدی پیوسته‌ای و باید ساختارش را سریع بفهمی.

به دایرکتوریِ ریشه‌ی پروژه برو

cd /path/to/project

Claude Code را اجرا کن

claude

یک مرورِ کلیِ سطح‌بالا بخواه

give me an overview of this codebase

عمیق‌تر در اجزای مشخص شیرجه بزن

explain the main architecture patterns used here

what are the key data models?

how is authentication handled?

کدِ مرتبط را پیدا کن

فرض کن باید کدِ مرتبط با یک قابلیت یا کارکردِ مشخص را پیدا کنی.

از Claude بخواه فایل‌های مرتبط را پیدا کند

find the files that handle user authentication

کانتکستِ نحوه‌ی تعاملِ اجزا را بگیر

how do these authentication files work together?

جریانِ اجرا را درک کن

trace the login process from front-end to database

رفعِ کارآمدِ باگ‌ها

فرض کن به یک پیامِ خطا برخورده‌ای و باید منشأ آن را پیدا و رفع کنی.

خطا را با Claude در میان بگذار

I'm seeing an error when I run npm test

پیشنهادِ رفع بخواه

suggest a few ways to fix the @ts-ignore in user.ts

رفع را اعمال کن

update user.ts to add the null check you suggested

بازنویسیِ کد

فرض کن باید کدِ قدیمی را به‌روز کنی تا از الگوها و شیوه‌های مدرن استفاده کند.

کدِ قدیمی برای بازنویسی را شناسایی کن

find deprecated API usage in our codebase

پیشنهادهای بازنویسی بگیر

suggest how to refactor utils.js to use modern JavaScript features

تغییرات را به‌شکلِ امن اعمال کن

refactor utils.js to use ES2024 features while maintaining the same behavior

بازنویسی را راستی‌آزمایی کن

run tests for the refactored code

کار با تست‌ها

فرض کن باید برای کدی که پوشش ندارد تست اضافه کنی.

کدِ بدونِ تست را شناسایی کن

find functions in NotificationsService.swift that are not covered by tests

اسکلتِ تست بساز

add tests for the notification service

موردهای تستِ معنادار اضافه کن

add test cases for edge conditions in the notification service

تست‌ها را اجرا و راستی‌آزمایی کن

run the new tests and fix any failures

Claude می‌تواند تست‌هایی بسازد که از الگوها و قراردادهای موجودِ پروژه‌ات پیروی کنند. وقتی تست می‌خواهی، درباره‌ی رفتاری که می‌خواهی راستی‌آزمایی شود دقیق باش. Claude فایل‌های تستِ موجودت را بررسی می‌کند تا سبک، فریم‌ورک‌ها و الگوهای assertionی را که از قبل به کار می‌روند تطبیق دهد.

برای پوششِ جامع، از Claude بخواه موردهای حاشیه‌ای را که شاید از قلم انداخته‌ای شناسایی کند. Claude می‌تواند مسیرهای کدت را تحلیل کند و برای شرایطِ خطا، مقادیرِ مرزی و ورودی‌های غیرمنتظره‌ای که به‌راحتی نادیده می‌مانند تست پیشنهاد دهد.

ساختنِ pull request

می‌توانی pull requestها را با درخواستِ مستقیم از Claude بسازی («create a pr for my changes»)، یا گام‌به‌گام Claude را در این کار راهنمایی کنی:

تغییراتت را خلاصه کن

summarize the changes I've made to the authentication module

یک pull request بساز

create a pr

بررسی و پالایش کن

enhance the PR description with more context about the security improvements

وقتی با gh pr create یک PR می‌سازی، نشست به‌طور خودکار به آن PR پیوند می‌خورد. برای بازگشت به آن در آینده، claude --from-pr <number> را اجرا کن یا URLِ آن PR را در جست‌وجوی انتخابگرِ /resume بچسبان.

مدیریتِ مستندسازی

فرض کن باید برای کدت مستندات اضافه یا به‌روز کنی.

کدِ بدونِ مستند را شناسایی کن

find functions without proper JSDoc comments in the auth module

مستندات بساز

add JSDoc comments to the undocumented functions in auth.js

بررسی و تقویت کن

improve the generated documentation with more context and examples

مستندات را راستی‌آزمایی کن

check if the documentation follows our project standards

کار در یادداشت‌ها و پوشه‌های غیرکدی

Claude Code در هر دایرکتوری‌ای کار می‌کند. آن را داخلِ یک گنجینه‌ی یادداشت‌ها، یک پوشه‌ی مستندات یا هر مجموعه‌ای از فایل‌های markdown اجرا کن تا محتوا را همان‌طور که کد را جست‌وجو، ویرایش و سازمان‌دهی می‌کنی، مدیریت کنی.

دایرکتوریِ .claude/ و CLAUDE.md بدونِ تداخل کنارِ دایرکتوری‌های پیکربندیِ ابزارهای دیگر می‌نشینند. Claude در هر فراخوانیِ ابزار فایل‌ها را تازه می‌خواند، پس ویرایش‌هایی را که در برنامه‌ای دیگر انجام می‌دهی، دفعه‌ی بعد که آن فایل را بخواند می‌بیند.

کار با تصاویر

فرض کن باید با تصاویری در کدبیست کار کنی و کمکِ Claude را برای تحلیلِ محتوای تصویر می‌خواهی.

یک تصویر به گفت‌وگو اضافه کن

می‌توانی از هرکدام از این روش‌ها استفاده کنی:

یک تصویر را به پنجره‌ی Claude Code بکش و رها کن
یک تصویر را کپی کن و با ctrl+v در CLI بچسبان (از cmd+v استفاده نکن)
مسیرِ یک تصویر را به Claude بده. مثلاً «Analyze this image: /path/to/your/image.png»

از Claude بخواه تصویر را تحلیل کند

What does this image show?

Describe the UI elements in this screenshot

Are there any problematic elements in this diagram?

از تصاویر برای کانتکست استفاده کن

Here's a screenshot of the error. What's causing it?

This is our current database schema. How should we modify it for the new feature?

از محتوای بصری پیشنهادِ کد بگیر

Generate CSS to match this design mockup

What HTML structure would recreate this component?

ارجاع به فایل‌ها و دایرکتوری‌ها

از @ استفاده کن تا بدونِ منتظرماندن برای خواندنِ Claude، فایل‌ها یا دایرکتوری‌ها را سریع بگنجانی.

ارجاع به یک فایلِ تکی

Explain the logic in @src/utils/auth.js

این کار محتوای کاملِ فایل را در گفت‌وگو می‌گنجاند.

ارجاع به یک دایرکتوری

What's the structure of @src/components?

این کار فهرستی از دایرکتوری همراه با اطلاعاتِ فایل‌ها می‌دهد.

ارجاع به منابعِ MCP

Show me the data from @github:repos/owner/repo/issues

این کار داده را از سرورهای MCPِ متصل با قالبِ @server:resource واکشی می‌کند. برای جزئیات به منابعِ MCP سر بزن.

اجرای Claude به‌صورتِ زمان‌بندی‌شده

فرض کن می‌خواهی Claude کاری را به‌طور خودکار و دوره‌ای انجام دهد، مثلِ بررسیِ PRهای باز هر صبح، ممیزیِ هفتگیِ وابستگی‌ها، یا بررسیِ شکست‌های CI در طولِ شب.

بسته به اینکه می‌خواهی کار کجا اجرا شود، یک گزینه‌ی زمان‌بندی انتخاب کن:

گزینه	کجا اجرا می‌شود	بهترین برای
Routines	زیرساختِ مدیریت‌شده توسطِ Anthropic	کارهایی که باید حتی وقتی کامپیوترت خاموش است اجرا شوند. علاوه بر زمان‌بندی، می‌تواند با فراخوانیِ API یا رویدادهای GitHub هم فعال شود. در claude.ai/code/routines پیکربندی کن.
Desktop scheduled tasks	دستگاهِ خودت، از طریقِ اپِ دسکتاپ	کارهایی که به دسترسیِ مستقیم به فایل‌های محلی، ابزارها یا تغییراتِ کامیت‌نشده نیاز دارند.
GitHub Actions	پایپ‌لاینِ CIِ تو	کارهایی که به رویدادهای مخزن گره خورده‌اند مثلِ PRهای بازشده، یا زمان‌بندی‌های cron که باید کنارِ پیکربندیِ ورک‌فلوت قرار بگیرند.
`/loop`	نشستِ فعلیِ CLI	نظرسنجیِ سریع وقتی یک نشست باز است. کارها وقتی گفت‌وگوی جدیدی شروع کنی متوقف می‌شوند؛ `--resume` و `--continue` آن‌هایی را که منقضی نشده‌اند بازمی‌گردانند.

درباره‌ی توانایی‌های Claude از خودش بپرس

Claude به مستنداتِ خودش دسترسیِ داخلی دارد و می‌تواند به سؤال‌ها درباره‌ی قابلیت‌ها و محدودیت‌های خودش پاسخ دهد.

نمونه‌سؤال‌ها

can Claude Code create pull requests?

how does Claude Code handle permissions?

what skills are available?

how do I use MCP with Claude Code?

how do I configure Claude Code for Amazon Bedrock?

what are the limitations of Claude Code?

ازسرگیریِ گفت‌وگوهای قبلی

وقتی یک کار در چند نشست انجام می‌شود، به‌جای توضیحِ دوباره‌ی کانتکست، از همان‌جا که رها کرده بودی ادامه بده. Claude Code هر گفت‌وگو را به‌صورتِ محلی ذخیره می‌کند.

claude --continue

این کار جدیدترین نشست را در دایرکتوریِ فعلی ازسر می‌گیرد؛ اگر هنوز نشستی نباشد، No conversation found to continue را چاپ می‌کند و خارج می‌شود. برای انتخاب از یک فهرست از claude --resume استفاده کن، یا از داخلِ یک نشستِ درحال‌اجرا /resume بزن. برای نام‌گذاری، شاخه‌زدن و مرجعِ کاملِ انتخابگر به مدیریتِ نشست‌ها سر بزن.

اجرای نشست‌های موازی با worktreeها

روی یک قابلیت در یک ترمینال کار کن درحالی‌که Claude در ترمینالی دیگر یک باگ را رفع می‌کند، بدونِ آنکه ویرایش‌ها با هم برخورد کنند. هر worktree یک checkoutِ جداگانه روی شاخه‌ی خودش است.

claude --worktree feature-auth

همین دستور را با نامی متفاوت در ترمینالِ دوم اجرا کن تا یک نشستِ موازیِ ایزوله شروع شود. برای پاک‌سازی، .worktreeinclude و پشتیبانیِ VCSِ غیرگیتی به Worktreeها سر بزن. برای پایش نشست‌های موازی از یک صفحه به‌جای ترمینال‌های جدا، به ایجنت‌های پس‌زمینه سر بزن.

برنامه‌ریزی پیش از ویرایش

برای تغییراتی که می‌خواهی پیش از نشستن روی دیسک بررسی‌شان کنی، به حالتِ برنامه (plan mode) برو. Claude فایل‌ها را می‌خواند و یک برنامه پیشنهاد می‌دهد ولی تا وقتی تأیید نکنی هیچ ویرایشی انجام نمی‌دهد.

claude --permission-mode plan

همچنین می‌توانی وسطِ نشست Shift+Tab را فشار دهی تا به حالتِ برنامه سوئیچ کنی. برای جریانِ تأیید و ویرایشِ برنامه در ویرایشگرِ متنت به حالتِ برنامه سر بزن.

واگذاریِ تحقیق به ساب‌ایجنت‌ها

کاوشِ یک کدبیسِ بزرگ کانتکستت را با خواندنِ فایل‌ها پر می‌کند. کاوش را واگذار کن تا فقط یافته‌ها برگردند.

use a subagent to investigate how our auth system handles token refresh

ساب‌ایجنت فایل‌ها را در پنجره‌ی کانتکستِ خودش می‌خواند و یک خلاصه گزارش می‌دهد. برای تعریفِ ایجنت‌های سفارشی با ابزارها و پرامپت‌های خودشان به ساب‌ایجنت‌ها سر بزن.

لوله‌کشیِ Claude به اسکریپت‌ها

Claude را به‌صورتِ غیرتعاملی برای CI، هوک‌های pre-commit یا پردازشِ دسته‌ای اجرا کن. stdin و stdout مثلِ هر ابزارِ یونیکسی کار می‌کنند.

git log --oneline -20 | claude -p "summarize these recent commits"

برای قالب‌های خروجی، پرچم‌های دسترسی و الگوهای fan-out به حالتِ غیرتعاملی سر بزن.

گام‌های بعدی

بهترین شیوه‌ها

الگوهایی برای بیشترین بهره‌بردن از Claude Code

مدیریتِ نشست‌ها

گفت‌وگوها را ازسر بگیر، نام‌گذاری و شاخه‌بندی کن

Worktreeها

نشست‌های موازیِ ایزوله را اجرا کن

گسترشِ Claude Code

اسکیل، هوک، MCP، ساب‌ایجنت و پلاگین اضافه کن