Agentic Research
Agent Learning Roadmap · Stage 2

Prompt Design

How do you state goals, data, rules, and output clearly?

Compare the limits of zero-shot, one-shot, few-shot, and CoT on fixed cases.

5–8 hours (with exercises)4 mapped lessonsUpstream edition

📌 Learning goals

  • Break a vague request into four parts: goal, data, rules, and output.
  • Tell the difference between zero-shot, one-shot, and few-shot: the difference is how many examples you give first.
  • Know that Chain-of-Thought means working through a problem in steps; it does not mean asking the model to reveal all its private thoughts.
  • Use the same small test set (eval) to compare before and after.
  • Notice when the problem is not the prompt, then change the model, data, or tool.

Entry conditions

Finish Stage 1 and be able to run a Python program; do the exercises first and open the required reading only when stuck.

🧭 Lessons on this site

Read in the suggested order; checkboxes share the same browser progress as the /learn track pages.
Progress here
0/4
Saved in your browser only
  1. 01
    Your First AI Task: How to Give Instructions It Gets Right

    Why first tasks usually fail — not because the tool is weak, but because the instruction has no output, no input, and no destination. Three elements, three real examples (each with its vague version for contrast), and how to judge how much freedom to give.

    7 min
  2. 02
    Prompt Engineering Systematic Methodology: From Few-shot to ReAct

    A complete methodology for Prompt Engineering: principles and practical applications of techniques such as Few-shot, Chain-of-Thought, Tree-of-Thought, ReAct, and Self-Consistency.

    6 min
  3. 03
    What an AI Agent Can Actually See on Your Computer

    Which files an AI Agent can read, whether it can go online, whether it can delete things, and whether what you say gets used for training. This article splits 'what can it do' into four separately verifiable questions, and explains what permission modes, sandboxes, and working directories each block — and don't.

    8 min
  4. 04
    Highly Useful Claude Code System Prompt Templates

    A curated set of battle-tested Claude Code system prompts, covering common scenarios such as code review, refactoring, and documentation generation.

    5 min

📚 Required reading

  1. 1.Anthropic Prompt Engineering Tutorial⭐⭐⭐⭐⭐Work through the notebook once.
  2. 2.OpenAI Prompt Engineering⭐⭐⭐⭐Read message hierarchy, examples, and evals.
  3. 3.Google Prompt Design Strategies⭐⭐⭐⭐See clear instructions, fixed structure, and repeated testing.

🎯 Curated resources

ResourceWho it's forPriorityWhy
Official docs
Anthropic Prompt Engineering 總覽
Want the official technique set⭐⭐⭐⭐Official documentation; every technique has a source.
Learn from cookbooks
Anthropic Courses
Want a course-style walkthrough⭐⭐⭐⭐Find the prompt evaluations closest to your task.
Learn from cookbooks
Anthropic Claude Cookbooks
Want ready notebooks⭐⭐⭐⭐Find the prompting cookbook notebooks.
Learn from cookbooks
OpenAI Cookbook
Need eval examples⭐⭐⭐⭐Find eval and structured-output examples.
Learn from cookbooks
Google Gemini Cookbook
Working with Gemini⭐⭐⭐⭐Run a prompting quickstart.
Reference
DAIR.AI Prompt Engineering Guide
Want a reference manual⭐⭐⭐⭐Use it as a lookup manual, not something to memorize.
Reference
PromptingGuide.ai
Need one technique fast⭐⭐⭐Find one technique quickly on the website.
Reference
NirDiamant Prompt Engineering
Learn by running code⭐⭐⭐Pick one notebook and learn by running it.
Chinese explanation
李宏毅 GenAI-ML(2025 Fall)
Want a Chinese classroom explanation⭐⭐⭐Classroom explanation in Chinese; a 2025 Fall course site, not current model documentation.
Eval & optimization
promptfoo
Want rerunnable evals⭐⭐⭐⭐Move the six-question eval into a rerunnable configuration.
Eval & optimization
DSPy
Want to optimize prompts with code⭐⭐⭐Use it when you want to optimize prompts with code.
Eval & optimization
Inspect AI
Need a formal eval package⭐⭐⭐Use it when you need a formal eval package.

🛠 Hands-on practice (upstream)

Full exercises & starter code

Summaries from the upstream curriculum; full code, cost, and latency estimates live upstream.

  1. Exercise 1: the four-part prompt — turn "help me sort this out" into a checkable prompt with goal/data/rules/output.
  2. Exercise 2: the power of examples — run the same task zero-shot, one-shot, and few-shot, scoring on a fixed six-question set.
  3. Exercise 3: a small eval — change one thing at a time, rerun the same questions, and keep the scores before concluding.
  4. The motto: goal → data → rules → output; state it clearly first, decide on examples second, and check with fixed questions last.

✅ Self-check

  • I can write out goal, data, rules, and output.
  • I can compare before and after using the same six questions.
  • I change one thing at a time and keep the scores.
  • I know that missing data or needed actions cannot be fixed by prompting alone.

Adapted from awesome-agentic-ai-zh (MIT, by Wenyu Chiou) v2026.09.23; links checked 2026-08-27. Stars mark learning priority (⭐⭐⭐⭐⭐ = you will get stuck without it), not popularity. MIT License · Curriculum structure last updated 2026-10-03. Content is still being filled in; lessons marked “in progress” are not live yet.