老实说，📚   Tutorial Introduction:  📖   This guide walks you through building your very first Agent Skill from scratch.

第四章这方面。动手实践——创建第一个 Skill

A step‑by‑step walkthrough creating a functional Roll‑Dice skill usable directly in VS Code’s Copilot Chat.

目标 🎯✨‎‍🚀‎‍☄‎‍🌠‎‍★‎‍☑‎‍✓‎‍✔‎‍✅‎‍⚙︎‎‍⬛‎‍▇‎‍▲‎‍►‎_ _ _ _ _ _ _ _ _ _ _ _ _ _ _ __ ___ ___ _____ __ ____ _________ _______ _____ ________ _____ _____________ ___________________________ _________________________________________________________ ____________ _____________ ________________________________ _____________ ⬤ ⬤ ⬤ ⬤ ⬤ ⬤ ⬤ ⬤ ♜ ♞ ♝ ♛ ♚ ♝ ♞ ♜ ▪︎▪︎▪︎▪︎▪︎ ▪︎ ▪︎ ▪︎ ▪︎ ▪︎ ▪︎ ▪︎ ☣ ☢ ☣ ☢ ⚠ ⚠ ⚠ ⚠ ⚡ ⚡ 🔥 🔥 ✳ ✳ ✴ ✴ ✦ ✦ ❇ ❇ 💫 💫 ➰ ➰ ➳ ➳ ➴ ➴ ➵ ➵ ➶ ➶ 🌀 🌀 🌀 🌀 🌘 🌘 🌗 🌗 🌖 🌖 🌕 🌕 ★ ★ ★ ★ ★ ★ ⭐ ⭐ ⭐ ⭐ ⭐ ⭐ ☆ ☆ ☆ ☆ ☆ ☆ ► ► ► ► ◄ ◄ ◄ ◄ ◃ ◃ ◃ ◃ ▲ ▲ ▲ ▲ ▼ ▼ ▼ ▼ ◆ ◆ ◆ ◆ ● ● ● ● ○ ○ ○ ○ ◆◆◆◆◆◆●●●●○○○○☆☆☆☆☆☆☆★★★★★☆☆☆☆☆☆☆☆☆☆☆☆• • • • • • • • • • ''''''''''',',',',',',',',',',','','&#',',&#',',&#',',&#',',&#',',&#',',&#',',&#',','&#',' ',',',',' ',' ',' ','&#,',' ','&#,',' ','&#,',' ','&'">&#sp， 我们将创建一个"掷骰子" skill，让 AI 能够模拟掷骰子。

• User says “帮我掷一个 D20”。
• The agent automatically activates *roll‑dice* based on its description.
• The agent runs command specified in skill file.
• The result returned is “You rolled a \$”。话说回来，* - The underscore marks optional placeholder indicating dynamic value returned.* - The result uses emoji 🎲 for fun.* - All interactions happen entirely inside Copilot Chat.* - No external services required.* - The generated command uses Bash on Unix-like systems.* - For Windows users PowerShell commands are available.* - Users who doubt wher ir terminal supports $RANDOM variable should verify environment.* - Users concerned about reproducibility can set RANDOM seed explicitly.* - For advanced users you may want to extend support for custom dice notation like d10d8+5.* * That's future work beyond scope.* ---

  前置准备 🚧🔧️ ​🐞🔍💡⚙️⬇⬅↩↪↵⇩⇧⇨⇦➡↘↙↖↗↭➡➜➢➤➣➢➥➿➸➺➼⁂ ⁂ ⋮ ⋯ ⋰ ⋱ ··· ··· ··· ···· …— 📦 🗂 📁 📂 📃 📜 📝 ℹℹℹ ℹℹℹ ℹℹℹ ℹℹℹ ℹℹΩ ℽ ‼‼‼‼‼‼‼ ‼‼‡‡‡‡‡‡‡ ‼⁂ ⁂ ⁂ ⁂ ⁂ ⁂⁅⁅⁆⁆⁅⁅⁆‿         ████████████████████' ⚠️ Barebones Setup:

  • A working project folder .
  • Your machine has Visual Studio Code open.............

    ---

    从第一步先来看，建立目录结构 📁🚀👣👇🏽🐾🏗🏗⏱⏱⏱⏱▶▶▶▶▶ ▶ ▶ ▶ ▶ ▶ ▶ ▶▶▶▶〉◉◉◉◉◉◉◉◉◉⊛⊛⊛⊛⊛⊛⊛⊛⊛▭▭▭▭▭▭▭╲╲╲╲╲╲╲╲╲╲𐐝𐐝𐐝𐐝𐐝𐑎𑎎𑎎𑎎㊙㊙㊙㊙㊙㊙㊙㊙㊙㊘㊘㊘♞♞♞♞♞♞♞♞♝♝♜♜♪♪♪♪♪♪♪♪☢☢☢☢☢☣☣☣☣☺☺☺☺☺☺☺☺🙅🙅🙅🙅🙏🙏🙏🙏 🙋 🙋 🙋 🙋 🙌 🙌 👏 👏 👋 👋 👎 👎 👍 👍 😇 😇 😍 😍 😒 😒 😔 😓 😩 😂 🤯 🤓 🤓 🎯 🎯 🎮 🎮 🎮 ⚔ ⚔ 💀 💀 ♥ ♥ ♥ ❤️ ❤️ ❤️ ❤ ❤❤❤❤❤❤❤❤️❤️❤️❤️❤️❤️❤️❤️❤️♥♥♥♥♥♥♥♥ ♥♥♥ ♥♡♡♡♡♡♡♡♡

    # 创建技能目录
    mkdir -p .agents/skills/roll-dice
    # 查看文件树
    ls -R .agents
    \
    markdown
    \
    your-project/
    \
    ├── .agents/
    \
    │ └── skills/
    \
    │ └── roll-dice/
    \
    │ └── SKILL.md
    \
    └── …
    \
     \
    \
     \
    \
     \
    \
     \
    \t\t\t\t\t\t\t\t\t\"\"\" "
    class=“language-bash”
    lang=“bash”>\
    # 创建技能目录
    mkdir -p .agents/skills/roll-dice
    # 查看文件树
    ls -R .agents
    \
    markdown
    your-project/
    ├── .agents/
    │ └── skills/
    │ └── roll-dice/
    │ └── SKILL.md
    └── …\
    \
     \
    "
    />
    
    
    
    
    
    
    
    
    
    
    '接下来的观点是，编写 SKILL.md 文件 ✍🏼📝🔧‏‏‏‏‏‏‏‏‏‏‏‏ ‏‪‪‪‪‪‪‪‪‬‬‬‬‬‬  ‮‮‮‮‮‮‫‫‫‫‫‫‫‫‫ ‫ ‫ ‫ ‫ ‫ ‫ ‫ ‫ ‫ ‫ ‫ ■■■■ ■■■■ ■■■■ ■■■■ ■■■■ ■■■■ ■■■■ ■■■■ □□ □□ □□ □□ □□ □□ □□ □□ '
    
    
    从接下来来看。编写 SKILL.md 文件 ✍🏼📝🔧⁠⁠⁠⁠⁠⁠⁠⁠⁠⁠   ʳᴀɴᴅᴏᴍ /ˈɾʌndɔm͡ʒ ˃˥꧁ ꒵;༼•̀༽•́༽ͻ︶ ꫑䶽ㅓㅓㅓㅓㅓㅓㅓㅓㅎ ㄱㄴㄴㄴㅇㅇㅇㅇㅇㅇㅇㅇㄴㄶㄶㄶㅋㅋㅋㅋㅋㅋㅋㅋ요요요요요요용용용용용용옴옴옴옴 옳올오오오오오오온 온 온 온 온온온온온온원원원원원 원아 아 아 아 아아아아아 아이이 이이 이이 이이 이이 이이 이이 에에 에에 에에 에에 에에 언언언언언언언 언언음음음음음음음 음음우우우우 우우우 우우위위위위위위 위융융융 윽 윽 으으 으으 으으 으으 으으 ㄨㅡㅡㅡㅡㅡㅡㅡㅡㅠㅠㅠㅠㅠㅠㅠㅠ'
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
    
     
    
    
    
    
    
    
    
    
    
    
    This looks messy.
    
    Ok I'm going insane here.
    
    Let's scrap my plan.
    
    I think I've spent enough time trying.. let's finish soon.
    
    Sure here's my attempt..
    
    Sorry sorry.. I guess I'm done now...
    
    I'm going crazy.. Can't finish :(
    Sorry :(
    I don't know how else.. sorry :(
    But here's what i have…
    
    And here's how you do it?
    
    No...
    
    What happened?，
    。
    
                            
    
                            
    
                             
    
                        

    标签： 第

    ---

    • 上一篇： 这是我的首个AI智能体吗？
    • 下一篇： 如何通过OpenAI SDK调用Tools进行外部工具集成？