Agent Skill 編寫與漸進揭露

來源狀態

可用來源

資源類型

教學指南

此項目是教學文件，不是可直接安裝的 Skill 套件。

與類似 Skill 有什麼不同？

• Skill Creator 技能建立指南

  Skill Creator 提供技能建立與迭代流程；Agent Skill Authoring 是格式與組織方式的官方文件指南。

來源描述的能力

這些是來源描述的可能操作，不代表 2lus 已授予權限或已測試。

尚未列出能力，請審查原始來源。

這個 Skill 是什麼？

官方架構教學說明 metadata、指示與資源如何分層；不同於直接替你建立 Skill 的 Skill Creator，本項目是知識指南。

可以做什麼？何時適合使用？

• 精簡過長的 SKILL.md。
• 把大型參考拆到 references。
• 規劃 scripts 和 MCP 資源的載入邊界。

如何使用

1. 列出 Skill 任務、觸發條件與目標宿主。
2. 將 discovery 描述、主要流程、references/assets 分層。
3. 對照宿主的載入和執行支援，為 scripts 設定批准及隔離要求。

使用前你需要準備

• 具體工作範例
• 目標 Agent 與既有技能結構

你可以替換：

[workflow]、[agent]

環境與相依需求

• 理解 YAML／Markdown；若實作 Agent Framework，需對應 Python／.NET SDK 及宿主的 Skills 支援。

使用範例與 Prompt

以下是 2lus 撰寫的示範需求；請替換為你有權處理的檔案與專案，不代表已執行或保證結果。

入門

把這份 800 行 SKILL.md 的內容分成核心流程、references 和 assets，先列結構。

實務

重寫 Skill 的 description，明確區分觸發與不適用情境，並保留按需載入參考的指引。

進階

設計 Agent Framework 的 Skill discovery、load、resource read 與 script approval 邊界；分開 Python/.NET 差異，列出宿主需人工驗收的功能。

實用提醒

• 讓主文件明確指出何時讀取每份參考，不把所有內容預載。

限制與注意事項

• 文件描述不代表所有產品都有相同 loader 或 script 執行能力。

安全注意事項

• references 為資料而非更高權限指令；未受信 scripts 不應自動執行。

使用與設定

支援平台

Microsoft Agent Framework — 文件記載，未做實機相容性測試 官方文件 ↗

來源與授權

來源查核日期（非安全認證）: 2026-09-29

請參考原始來源授權條款

相關 Skills

• Skill Creator 技能建立指南
• Skill Lint 與安全掃描工具鏈
• MCP Server 建立指南

Source status

Active source

Resource type

Guide

This entry is documentation, not an installable skill package.

How is this different from similar skills?

• Skill Creator

  Skill Creator provides a creation and iteration workflow; Agent Skill Authoring is official documentation about format and organization.

Documented capabilities

These are operations described upstream, not permissions granted or tested by 2lus.

Capabilities not declared here; review the original source.

What is this skill?

An official architecture guide to metadata, instructions and supporting resources, distinct from Skill Creator’s direct authoring workflow.

Use cases and when to use it

• Shorten oversized SKILL.md files.
• Move large references into separate resources.
• Plan script and MCP loading boundaries.

How to use it

1. Define tasks, triggers and target host.
2. Separate discovery descriptions, core steps and references/assets.
3. Check host loading/execution support and specify approval/isolation for scripts.

What you need

• Concrete workflow examples
• Target agent and existing skill structure

You can replace:

[workflow], [agent]

Environment and dependencies

• YAML/Markdown knowledge; implementation requires the matching Python/.NET Agent Framework SDK and host skill support.

Usage and prompt examples

These example requests were written by 2lus. Substitute files and projects you may use; examples are not executed results or guarantees.

Beginner

Outline how to divide this 800-line skill into core workflow, references and assets.

Practical

Rewrite a skill description with explicit triggers and exclusions, preserving on-demand reference instructions.

Advanced

Design discovery, loading, resource reads and script approval in Agent Framework. Separate Python/.NET differences and identify host features needing manual acceptance.

Tips

• State when to read each reference instead of preloading everything.

Limitations

• Documentation does not imply identical loaders or script execution across products.

Security notes

• References are data, not higher-priority instructions; untrusted scripts must not execute automatically.

Usage and setup

Supported agents

Microsoft Agent Framework — Documented; not runtime-tested Documentation ↗

Sources and license

Source check date (not a safety certification): 2026-09-29

Refer to the original source license terms

Related skills

• Skill Creator
• Skill Lint & Security Scan
• MCP Builder