SKILL.make：Makefile 风格的 Skill 文件
发布: (2026年5月2日 GMT+8 16:18)
4 分钟阅读
原文: Hacker News
Source: Hacker News
SKILL.make: Makefile 风格的 Skill 文件
规范和参考实现，针对 Makefile‑styled Agent Skills。
这是什么？
SKILL.make 将 Makefile 的声明式、依赖驱动范式引入 Agent Skills 格式。它用结构化逻辑取代模糊的散文，将 SKILL.md 转变为可复现的执行图。
为什么使用 Makefile 风格的 SKILL 文件？
- Token Efficient – 优化的语法将 SKILL 文件大小减少约 15 %，节省成本和上下文窗口空间。通过手动优化，上下文大小可降低超过 30 %。
- Dependency Resolution – 该框架自动解析有向无环图（DAG）。不再依赖 LLM “猜测”下一步的逻辑。使用 Target : Dependency + Recipe 模型，确保代理严格按执行顺序进行，不会跳过步骤。
- Highly Composable – 通过在不同文件之间调用目标，实现技能的模块化——就像专业的构建系统。
- Auditability and Evolution – 为可审计、可演进的 SKILL 实现奠定基础。
Rule Definitions
| Prefix | Type | Description |
|---|---|---|
VAR = val | Variable | 定义常量以减少重复。 |
@ cmd | Shell | 直接的命令行指令用于执行。 |
$ tool | Invocable | 显式调用代理定义的工具/函数。 |
? prompt | Reasoning | 自由形式的提示，由代理决定行动。 |
ifeq | Logic | 基于状态或环境变量的条件分支。 |
multi-line string | Code snippet | 使用 Makefile 语法的多行字符串定义代码片段。 |
一个简单示例
下面是一个典型的以 SKILL.make 格式编写的代码审查技能：
# Variables
CODE_DIR = src/
# Target: review — run a full code review
review: lint test summary
lint:
@ cd $(CODE_DIR) && eslint . --format json
test:
@ cd $(CODE_DIR) && npm test
summary: lint test
? Based on lint errors and test failures, write a review summary.附加信息也是可以的。
Source: …
格式比较
我们使用 Makefile 格式测试了完整的 SKILL 集合（来自著名的 “Skills for Real Engineers”）。它改进了逻辑结构和可读性，SKILL.make 文件非常适合审计（git 跟踪、调用统计），并为 Evolution Engineering 打下坚实基础。
您可以使用 convert.sh 重新进行此转换。比较统计如下：
| 文件 | SKILL.md | SKILL.make | 变化 |
|---|---|---|---|
| caveman | 1916 | 1714 | -10% |
| design‑an‑interface | 3366 | 2789 | -17% |
| domain‑model | 3512 | 3376 | -3% |
| edit‑article | 721 | 692 | -4% |
| git‑guardrails‑claude‑code | 2312 | 1861 | -19% |
| github‑triage | 10089 | 8697 | -13% |
| improve‑codebase‑architecture | 5509 | 4913 | -10% |
| migrate‑to‑shoehorn | 2795 | 1328 | -52% |
| obsidian‑vault | 1511 | 1233 | -18% |
| qa | 4965 | 4781 | -3% |
| request‑refactor‑plan | 2711 | 2626 | -3% |
| scaffold‑exercises | 3589 | 2744 | -23% |
| setup‑pre‑commit | 2261 | 1703 | -24% |
| tdd | 4211 | 3212 | -23% |
| to‑issues | 2737 | 2027 | -25% |
| to‑prd | 2460 | 2092 | -14% |
| triage‑issue | 3783 | 3160 | -16% |
| ubiquitous‑language | 4890 | 4560 | -6% |
| write‑a‑skill | 3056 | 2879 | -5% |
| 总计 | 66394 | 56387 | -15% |
状态
这是一份 概念验证 规范。它旨在兼容大多数 Agent Harness 实现。