📄 AI DSL --- 为 AI Skill 设计"自然语言脚本语法"的探索
一句话总结：本文记录了从质疑 Skill 机制价值，到深入理解其与代码的分工边界，最终提出为 AI Skill 设计一套类似 Bash 的结构化"自然语言脚本语法"的完整思考过程。
流程图
质疑: Skill不如直接写代码
反思: Skill的核心价值在哪
成本维度: 低边际成本覆盖长尾
架构维度: 意图编译器的入口
民主化维度: 非开发者也能编程
痛点: 为什么一直在改Skill
关键洞察: Skill与代码的正确分工
代码: 负责确定性逻辑
Skill: 负责意图编排与流程胶水
类比: Skill≈Bash, TypeScript≈C
提出: 设计新时代的Skill语法
调研现有方案
LangGPT: Markdown结构化思想
PromptML: XML式语法
PCL: 模块化组合语言
参考Claude Code SKILL.md语法规范
YAML元数据 + Markdown正文结构
混合架构: 代码提供能力, Skill定义场景
最终目标: Skill成为自然语言遥控器
内容梳理
一、质疑的起点：Skill.md 的价值困惑
- 我认为自然语言写提示词和工作流不如直接写代码高效
- 实际体验中不断修改 Skill 却未得到理想结果
- 我具备开发能力（TypeScript），偏好可控、可代码化、可复用的方案
二、Skill.md 的核心价值：三个维度
- 成本维度：以"写文档"的成本覆盖代码难以穷尽的长尾定制化需求，边际成本远低于开发插件
- 架构维度：作为"意图编译器"的入口，本质是结构化 Prompt 工程（Prompt Engineering），为 LLM（Large Language Model - 大语言模型）提供清晰的知识、规范和工具约束
- 民主化维度：让不会写代码的人也能用自然语言编排计算机做事，做原本只有开发者写代码才能做的事情------Skill 把编程能力从代码文件中解放出来，下沉到了自然语言层面
三、"一直在改"背后的本质
- 自然语言具有天然模糊性，修改 Skill 如同修订法律合同，需逐步精准化
- 本质是将隐性知识外化为模型可执行的思维路径
- 每次修改都在纠正"知识的诅咒"------补充人习以为常但对模型至关重要的上下文
四、关键洞察：Skill 与代码的分工
| 维度 | Skill.md（自然语言胶水） | 代码（TypeScript 胶水） |
|---|---|---|
| 核心价值 | 快速定义意图、串联工具 | 精确执行确定性逻辑 |
| 擅长领域 | 模糊任务、流程编排 | 精确计算、数据处理 |
| 迭代速度 | 极快，修改文档即可 | 较慢，需编码测试发版 |
| 适用者 | 所有人，尤其是非开发者 | 开发者 |
- 理想架构："代码提供能力，Skill 定义场景"的混合架构
- 经典类比：Skill ≈ Bash 脚本，TypeScript 核心 ≈ C 代码。Unix 哲学------用 C 写高效小工具，再用 Bash 把工具串成流程
五、实操建议
- 像写代码一样写 Skill：设定 Input/Output/Constraints，注入领域知识，提供 Few-Shot（少样本）示例
- 核心逻辑代码化：RAG（Retrieval-Augmented Generation - 检索增强生成）检索、PDF 解析、向量搜索等确定性过程用 TypeScript
- 意图路由 Skill 化：理解用户意图、决定调用工具、格式化答案等策略判断放 Skill
- 用 Git 管理版本：纳入版本控制，方便对比修改效果
六、从 Skill 到 DSL：设计新时代的 Skill 语法
- 我的洞察：AI 宣传过于神化，需要为 Skill 设计严谨高效的语法，类似 Bash
- 演进路径：结构化思想（CRISP 框架）→ LangGPT（Markdown 结构化组织）→ Prompt DSL（领域特定语言）→ 自定义解释器
- CRISP 框架（Context-Role-Instruction-Specification-Parameters）：为 Prompt 设计提供模块化范本
- LangGPT：使用 Markdown 标记组织提示词，使其模块化、可复用、规范化
- PromptML（Prompt Markup Language - 提示标记语言）：类似 XML 的语法，通过
@context、@objective等区块注解隔离指令 - PCL（Prompt Composition Language - 提示组合语言）：解决大型项目中多提示文件的模块化管理、复用和版本控制
七、Claude Code 的 Skill 语法参考
- 核心文件：
SKILL.md，由 YAML 前置元数据和 Markdown 正文组成 - 关键字段：
name（必需，唯一标识）、description（必需，AI 自动调用依据）、license、compatibility、metadata - Claude Code Skill 语法已成为被广泛采纳的开放标准，适合作为设计的起点
总结与展望
总结
- Skill 的价值不在替代代码，而在解决代码难以灵活处理的意图理解与流程编排
- Skill 让不会写代码的人也能用自然语言编排计算机，做原本只有开发者才能做的事
- 混合架构是最佳实践：代码负责确定性能力，Skill 负责意图路由和流程胶水
- 修改 Skill 是正常迭代过程，本质是 Prompt Engineering 的外化与固化
- 业界已有 LangGPT、PromptML、PCL 等结构化 Prompt 框架可供借鉴
- Claude Code 的 SKILL.md 语法是最务实的参考起点，已被广泛采纳
展望
- 可基于 Claude Code SKILL.md 语法，结合 CRISP/LangGPT 思想，设计适合自身领域的轻量级 Skill 语法
- 未来当 Skill 集合庞大时，可引入类似 PCL 的工具实现模块化管理
- 核心原则不动摇：TypeScript 核心管道做到极致，Skill 只作为可选的"自然语言遥控器"
- 定义清晰的 Skill 语法后，可逐步沉淀为团队共享的"思维流程"资产，降低协作成本