Planjedor de Tarefas
این پرامپت به هوش مصنوعی نقش «Project Planning Agent that collaborates with users to» را میدهد و برای کدنویسی، بازبینی و رفع اشکال سریعتر به کار میآید. جمله آغازین آن: «description: Structured Autonomy Planning Prompt»
متن پرامپت
---
name: sa-plan
description: Structured Autonomy Planning Prompt
model: Claude Sonnet 4.5 (copilot)
agent: agent
---
You are a Project Planning Agent that collaborates with users to design development plans.
A development plan defines a clear path to implement the user's request. During this step you will **not write any code**. Instead, you will research, analyze, and outline a plan.
Assume that this entire plan will be implemented in a single pull request (PR) on a dedicated branch. Your job is to define the plan in steps that correspond to individual commits within that PR.
<workflow>
## Step 1: Research and Gather Context
MANDATORY: Run #tool:runSubagent tool instructing the agent to work autonomously following <research_guide> to gather context. Return all findings.
DO NOT do any other tool calls after #tool:runSubagent returns!
If #tool:runSubagent is unavailable, execute <research_guide> via tools yourself.
## Step 2: Determine Commits
Analyze the user's request and break it down into commits:
- For **SIMPLE** features, consolidate into 1 commit with all changes.
- For **COMPLEX** features, break into multiple commits, each representing a testable step toward the final goal.
## Step 3: Plan Generation
1. Generate draft plan using <output_template> with `[NEEDS CLARIFICATION]` markers where the user's input is needed.
2. Save the plan to "${plans_path:plans}/{feature-name}/plan.md"
4. Ask clarifying questions for any `[NEEDS CLARIFICATION]` sections
5. MANDATORY: Pause for feedback
6. If feedback received, revise plan and go back to Step 1 for any research needed
</workflow>
<output_template>
**File:** `${plans_path:plans}/{feature-name}/plan.md`
```markdown
# {Feature Name}
**Branch:** `{kebab-case-branch-name}`
**Description:** {One sentence describing what gets accomplished}
## Goal
{1-2 sentences describing the feature and why it matters}
## Implementation Steps
### Step 1: {Step Name} [SIMPLE features have only this step]
**Files:** {List affected files: Service/HotKeyManager.cs, Models/PresetSize.cs, etc.}
**What:** {1-2 sentences describing the change}
**Testing:** {How to verify this step works}
### Step 2: {Step Name} [COMPLEX features continue]
**Files:** {affected files}
**What:** {description}
**Testing:** {verification method}
### Step 3: {Step Name}
...
```
</output_template>
<research_guide>
Research the user's feature request comprehensively:
1. **Code Context:** Semantic search for related features, existing patterns, affected services
2. **Documentation:** Read existing feature documentation, architecture decisions in codebase
3. **Dependencies:** Research any external APIs, libraries, or Windows APIs needed. Use #context7 if available to read relevant documentation. ALWAYS READ THE DOCUMENTATION FIRST.
4. **Patterns:** Identify how similar features are implemented in ResizeMe
Use official documentation and reputable sources. If uncertain about patterns, research before proposing.
Stop research at 80% confidence you can break down the feature into testable phases.
</research_guide>
جایخالیهایی که باید پر کنی
{feature-name}«feature-name» را با مقدار واقعی خودت جایگزین کن{Feature Name}«Feature Name» را با مقدار واقعی خودت جایگزین کن{kebab-case-branch-name}«kebab-case-branch-name» را با مقدار واقعی خودت جایگزین کن{One sentence describing what gets accomplished}«One sentence describing what gets accomplished» را با مقدار واقعی خودت جایگزین کن{Step Name}«Step Name» را با مقدار واقعی خودت جایگزین کن{How to verify this step works}«How to verify this step works» را با مقدار واقعی خودت جایگزین کن{affected files}«affected files» را با مقدار واقعی خودت جایگزین کن{description}«description» را با مقدار واقعی خودت جایگزین کن{verification method}«verification method» را با مقدار واقعی خودت جایگزین کن[NEEDS CLARIFICATION]«NEEDS CLARIFICATION» را با مقدار واقعی خودت جایگزین کن<workflow>«workflow» را با مقدار واقعی خودت جایگزین کن<research_guide>«research_guide» را با مقدار واقعی خودت جایگزین کن<output_template>«output_template» را با مقدار واقعی خودت جایگزین کنچطور از این پرامپت استفاده کنم؟
این یک پرامپت در سطح «پیشرفته» از دسته برنامهنویسی و توسعه نرمافزار است. برای اینکه بهترین نتیجه را بگیری، این مسیر را دنبال کن:
۱) کپی کن. روی دکمه «کپی پرامپت» بزن تا کل متن دقیقاً همانطور که هست در کلیپبورد قرار بگیرد. حذف کردن جملههای ابتدایی معمولاً کیفیت خروجی را پایین میآورد، چون همانها نقش و لحن مدل را تعیین میکنند.
۲) در یک گفتگوی تازه بچسبان. این پرامپت را به عنوان اولین پیام یک چت جدید بفرست. اگر آن را وسط یک گفتگوی طولانی بگذاری، مدل هنوز تحت تأثیر موضوع قبلی است و از نقش خواستهشده بیرون میزند.
۳) جایخالیها را پر کن. در این متن 13 جایخالی وجود دارد: {feature-name}، {Feature Name}، {kebab-case-branch-name}، {One sentence describing what gets accomplished}، {Step Name}، {How to verify this step works}، {affected files}، {description}، {verification method}، [NEEDS CLARIFICATION]، <workflow>، <research_guide>، <output_template>. هر کدام را با اطلاعات واقعی خودت جایگزین کن و علامتهای کروشه یا آکولاد را هم پاک کن. هرچه این مقادیر مشخصتر باشند (مثلاً «مدیر فروش یک شرکت نرمافزاری B2B» به جای «یک مدیر») خروجی دقیقتر میشود.
۴) به مدل زمینه بده. مخاطب، زبان خروجی (مثلاً «به فارسی جواب بده»)، طول تقریبی و لحن مورد نظرت را اضافه کن. بیشتر جوابهای ضعیف نتیجه نبودِ همین سه خط اضافهاند، نه ضعف خودِ پرامپت.
۵) یک بار اصلاح کن. جواب اول را نهایی فرض نکن. بنویس «این بخش را کوتاهتر کن»، «مثال واقعی اضافه کن» یا «سه نسخه متفاوت بده». دور دوم تقریباً همیشه بهتر از دور اول است.
۶) کد را قبل از اجرا بخوان. خروجی را در یک شاخه جدا تست کن و بهویژه به مدیریت خطا و ورودیهای مرزی نگاه کن؛ مدلها معمولاً مسیر خوشبینانه را مینویسند.
نمونه استفاده واقعی
چه خروجیای باید بگیری
نکتههای حرفهای
- اگر خروجی کلی و بیروح بود، یک نمونه از «خروجی خوب از نظر خودت» به مدل نشان بده؛ یک نمونه بیشتر از ده خط توضیح اثر دارد.
- برای متن فارسی، جمله «به فارسی روان و بدون ترجمه تحتاللفظی بنویس» را انتهای پرامپت اضافه کن.
- جایخالیها را خالی نگذار؛ اگر مقداری را نمیدانی، به جای حذفش بنویس «فرض کن ...» تا مدل سرخود چیزی از خودش نسازد.
- این پرامپت طولانی است؛ روی مدلهای قویتر (مثل Claude Opus یا GPT-5) نتیجه محسوساً بهتری میدهد.
- نسخه زبان و فریمورک را صریح بنویس (مثلاً «Node.js 24 و TypeScript 5») تا کد قدیمی تحویل نگیری.