diff --git "a/docs/bluebook/\347\254\254\344\270\200\347\257\207 \344\275\277\347\224\250\346\211\213\345\206\214\357\274\232\345\205\210\346\212\212 WorkBuddy \347\224\250\350\265\267\346\235\245/\347\254\254 5 \347\253\240 WorkBuddy\345\212\240\350\275\275\344\270\200\344\270\252\347\234\237\346\255\243\347\224\250\345\276\227\344\270\212\347\232\204 Skill/index.md" "b/docs/bluebook/\347\254\254\344\270\200\347\257\207 \344\275\277\347\224\250\346\211\213\345\206\214\357\274\232\345\205\210\346\212\212 WorkBuddy \347\224\250\350\265\267\346\235\245/\347\254\254 5 \347\253\240 WorkBuddy\345\212\240\350\275\275\344\270\200\344\270\252\347\234\237\346\255\243\347\224\250\345\276\227\344\270\212\347\232\204 Skill/index.md"
index 639434c..e14b7a7 100644
--- "a/docs/bluebook/\347\254\254\344\270\200\347\257\207 \344\275\277\347\224\250\346\211\213\345\206\214\357\274\232\345\205\210\346\212\212 WorkBuddy \347\224\250\350\265\267\346\235\245/\347\254\254 5 \347\253\240 WorkBuddy\345\212\240\350\275\275\344\270\200\344\270\252\347\234\237\346\255\243\347\224\250\345\276\227\344\270\212\347\232\204 Skill/index.md"	
+++ "b/docs/bluebook/\347\254\254\344\270\200\347\257\207 \344\275\277\347\224\250\346\211\213\345\206\214\357\274\232\345\205\210\346\212\212 WorkBuddy \347\224\250\350\265\267\346\235\245/\347\254\254 5 \347\253\240 WorkBuddy\345\212\240\350\275\275\344\270\200\344\270\252\347\234\237\346\255\243\347\224\250\345\276\227\344\270\212\347\232\204 Skill/index.md"	
@@ -21,8 +21,16 @@ my-skill/
     └── template.pptx
 ```
 
-其中只有 `SKILL.md` 是必须的。
+刚才看到的目录结构中，每个部分各有用途：
 
+| 路径 | 是否必须 | 说明 |
+| --- | --- | --- |
+| `SKILL.md` | 是 | Skill 的核心入口，包含元数据（名称、描述）和执行指令。Agent 启动时只读取其中的元数据部分，激活后才加载完整内容。 |
+| `scripts/` | 否 | 存放可执行脚本，如 Python、Shell 等。Agent 在执行过程中按需调用，不会提前加载。 |
+| `references/` | 否 | 存放参考资料，如风格指南、业务规则、API 文档等。Agent 在需要时读取，用于补充上下文。 |
+| `assets/` | 否 | 存放模板、图片、数据文件等资源。Agent 在生成输出时引用，例如用 `.pptx` 模板生成 PPT。 |
+
+`SKILL.md` 样例：
 ```Markdown
 ---
 name: tech-article-writing
@@ -127,7 +135,7 @@ Skill = 做法
 
 ## Skill 有哪些作用
 
-**第一个作用，是给模型补充程序性知识。**大模型往往知道大量知识，但未必知道你的事情具体应该怎么做，比如它知道 SQL，但它不知道你公司的：
+**第一个作用，是给模型补充程序性知识。** 大模型往往知道大量知识，但未必知道你的事情具体应该怎么做，比如它知道 SQL，但它不知道你公司的：
 
 ```Plain Text
 canonical user_id 在哪张表
@@ -140,7 +148,7 @@ Grafana 对应 dashboard ID 是多少
 
 
 
-**第二个作用，是固定复杂工作流，**比如做一次行业调研。
+**第二个作用，是固定复杂工作流，** 比如做一次行业调研。
 
 普通 Prompt 可能是：