把 Skill 当函数写的人
GitHub 上有个仓库,一顆星,没有 README。介绍只有仓库描述里的一行:Ming's skills to share for the up skill。里面是十一个给 Claude Code 用的 skill,创建于九月,最后更新在十月底。
把 Skill 当函数写的人
GitHub 上有个仓库,一顆星,没有 README。介绍只有仓库描述里的一行:Ming's skills to share for the up skill。里面是十一个给 Claude Code 用的 skill,创建于九月,最后更新在十月底。
点进去,先看到的是一件没人做的小事:每个 skill 的开头都有一张表。
给 skill 签名
那张表长这样:input1 是什么文件,processing 用哪个 skill 处理它,output1 是什么。「更新过的 input1」——连「这个输出改的是哪个输入」都要写明。下面还有一条封装规则:skill 的正文只许引用输入清单里列出的东西;skill 写出的任何文件,必须是某个输出行。清单外的引用,视为破封装。
熟悉函数的人一眼就懂:这是签名。输入类型、副作用、返回值,全摆在门口。大多数人的 skill 是一段提示词,写成什么样全看当时心情;这个人的 skill 是一个有接口约定的小程序——出了问题,可以指着签名说清楚是哪一格断了。每份 SKILL.md 旁边还有一份 usage.md,专给人看:一句话调用语,加一组 Before/After 对比图。给模型读的和给人读的,分开两个文件。管这件事的 skill 叫 unit__skill__promote,目标是「当朋友拿到它时会说:太有用了,我得存下来」——库里连「把 skill 打磨到值得保存」都做成了一个 skill,带自己的词表规范:Scope、Level、Subject 三套词汇互不重叠,缺的值先登记进 schema 再许用,按作者的说法,这样读者不用知道词表内容也能给任何标签分类。
上下文是预付成本
另一个 skill 处理一件所有重度用户都会遇到的事:默认 skill 目录里的东西,每开一次会话就加载一次——装得多,预付的上下文就多。它给出三个杠杆:低频的 skill 挪进旁边的 on_demand 目录,从「每次预付」变成「用时按路径取」,成本归零;留下的 description 削成一句相关性闸门,不写摘要;能合并的合并成一个 flow 入口,作者举例能从一百个入口收到十个。最有意思的是其中一条硬规则:只有用户本人能决定哪个 skill 算低频,agent 永远不得自行移动。省钱和越权之间画了条线。
文件名当执法者
整个仓库里最讲究的一个 skill,管的是怎么写架构决策文档。规则是:文档只许写「期望的终态」,文件名就叫 desired__structure.md——作者的问答集里解释了为什么不用 proposed 或 plan:proposed 会诱人写对比,而对比是最先腐烂的部分;plan 模棱两可,既像终点又像步骤。名字叫 desired 的文件,想写「过去是什么样」的时候,文件名先说不。
写完不算数,要拿真实案例逐个干跑:读代码、数数。「18 条规则」「807 行」「被六个单元读取」是证据,「可行」不是。作者有句话值得抄下来:讲道理的答案,就是穿了好看衣服的猜测。发现要编号,改了一处要全量重跑——因为已通过的案例共享同一份终态文档,救了这一个的修改,往往是被那一个抓到的问题。最后一条:变更落地后,这份文档就删掉,留在旁边的文档会漂移。
其余的
剩下的是些有个人指纹的规矩。Python 那份要求同一个名字贯穿所有层——词表术语、类属性、字典键、数据库列、枚举值,只许大小写约定不同,任何其他差异都叫「解释债」。决策和理由不写进代码注释(省 token),写进 skill 自己的 _meta/decisions.md——那个问答集本身就是库里的精华,每个决定配一组「为什么不那样」。也有纯属口味的:网络请求用 aiohttp 不用 httpx,写模型时用 model_construct 跳过校验换速度——这类规则接受之前得知道是取舍不是真理。库外还配了一套钩子:状态栏和写后钩子挂在一个叫 graft 的 npm 包上,外加一个 MCP 服务器;发布出去的配置里硬编码了作者本机的路径,好在这只是多重回退里的一路,fork 的人不至于开箱即坏。还有一个和工程无关的 low-poly-village,教 Claude 从零攒一个 Dorfromantik 风格的浏览器小游戏——连它是「一个文件夹从 index.html 打开、无构建步骤」都写成了规则。
十一份 skill,一份签名规范,一份词表,一套上下文成本算法——这个仓库自己的计量单位是「默认目录里的 skill 数,乘以每次会话」,挪一个低频 skill 出去,这笔预付款就永久少一项。一个问答集。没有星,没有围观者,作者照常在十月推送更新。签名表在门口摆着——这大概就是它全部的野心。
*信源:github.com/mingzilla/public_skills(仓库全文 clone 直读,11 个 skill;元数据来自 GitHub API:创建 2026-09-04、最后推送 2026-10-22、1 star、34 followers)。引文均出自仓库内 SKILL.md 与 _meta/decisions.md 原文。*