Claude Skills2025.06

设计理念： Claude Skills 采用模块化设计，各项能力既能独立使用，也能组合发挥。比如处理一份英文技术文档时，可以同时用到「文件解析」提取内容、「多语言处理」翻译、「内容创作」润色，形成完整的工作流。

核心组成

分层加载机制 (Progressive Disclosure)

Skills 采用渐进式披露设计，实现高效的上下文管理：

• 第一层： 仅加载所有 Skills 的 name 和 description（约 100 tokens）
• 第二层： 需要时才加载具体的 SKILL.md 文件
• 第三层： 按需读取 scripts 或 reference 中的具体文件

write-markdown-file/
├── SKILL.md            # 能力说明书：目标/输入/步骤/产物/失败处理/MCP端点（必需，大写）
├── skill.meta.json     # 元数据：name/version/tags/context_budget/owners（可选）
├── LICENSE.txt         # 许可证文件（必需）
├── scripts/            # 可执行脚本：python/shell/js 等（可选）
│   ├── run.py
│   ├── write_file.py
│   └── utils.py
├── references/         # 参考文档：摘录/摘要/页码/链接（最小必要量，可选）
│   ├── api_docs.md
│   └── policy_excerpt.md
├── assets/             # 模板/样例：docx、xlsx、prompt片段（可选）
│   ├── report_template.docx
│   └── config.json
├── tests/              # 回放与自检：测试数据/断言（可选）
│   └── replay_case.md
└── CHANGELOG.md        # 变更记录（推荐）

📁 目录说明

💡 核心设计理念

• 模块化封装： 一个 Skill = 一个文件夹，职责明确，可独立演进与回滚
• 分层加载： 先读元数据/目录结构 → 按需加载 SKILL.md → 需要时才最小化加载 scripts/ 和 references/
• MCP × Skills 正交： MCP 解决"怎么连"，Skills 解决"怎么做"；组合 = 标准通信 + 能力封装
• 工程化迁移： 将"大 System Prompt"拆成多个职责明确的 Skills，显著降低上下文压力

🎯 应用场景与价值

---
name: write-markdown-file
description: Writes provided text content to a specified Markdown file.
---

## Write Markdown File
This skill takes text content and a filename, then writes the content 
to the specified Markdown file.

### Steps:
1. Receive `filename` and `content` as input.
2. Create or overwrite the file at `filename` with `content`.
3. Confirm successful writing.

### Usage:
```python
def write_file(filename: str, content: str):
    # This function will be called by the agent
    pass
```

def write_file(filename: str, content: str) -> dict:
    """
    将文本内容写入指定的 Markdown 文件。
    
    Args:
        filename: 目标文件路径
        content: 要写入的文本内容
    
    Returns:
        包含执行状态的字典
    """
    try:
        with open(filename, 'w', encoding='utf-8') as f:
            f.write(content)
        return {
            "success": True,
            "message": f"Successfully wrote to {filename}"
        }
    except Exception as e:
        return {
            "success": False,
            "message": f"Error: {str(e)}"
        }