如何看待由 OpenClaw 作者引发的 “Loop 工程” 讨论?

AI

OpenClaw 作者 Peter 在社媒发帖,声称开发者不应该继续直接写 Prompt,而应该设计 Loop(循环) 来 Prompt Agent。

这个帖子引发开发者热议,诞生了新的词汇 “Loop 工程” 与 “Loop 工程师” 等等。

作者:划水的青蛙
链接:https://www.zhihu.com/question/2048003050531558553/answer/2048042592902943048
来源:知乎
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

过去一年,Agent开发领域连续造了三个词。

2025 年中,Context Engineering。

2026 年初,Harness Engineering。

2026 年中,Loop Engineering。

每个词出来后,大家其实都有点云里雾里,为什么?因为随着深入了解,感觉每个词中涉及的概念,和其他词都互有重叠。比如Harness中的很多落地手段,其实也是在合理管理上下文。

所以,这三个词不是替代关系,是叠加与包含关系。新的概念并不是干掉老的概念,而是在老概念的基础上,随着业界出现新的问题,又进行的“填坑”。

在真正工程落地实践时,三个概念往往处于一种叠加态。任何一个部分没做好,可能都会影响整个Agent的效果。

三个词,三次更细化的总结

Context Engineering,2025 年中。 Context Engineering,讨论的核心很单纯。上下文窗口是稀缺资源,不管是从Token Cost管理的角度,还是模型效果的角度,在Agent工作的过程中,上下文窗口中塞什么、不塞什么、按什么顺序塞,都需要有合理的管理。

Harness Engineering,2026 年初。 上下文管好了,新的问题冒出来,Agent 一旦跑长任务,模型自己的能力短板就藏不住了。

比如,

  • Agent循环时,陷入所谓的“复读机”情况,一直陷入了一个“舒适区”,不肯换一个方式解决问题,从而导致任务陷入死循环。
  • Agent越权,进行了危险操作,在Prompt中的软约束失效,需要用硬约束来兜底
  • Agent丢记忆,上下文尽管塞了所有信息,但是重要的信息被稀释了,模型可能抓不住重点。(这层和上下文工程相关)

所有给Agent加约束的工程手段都被装进 Harness这个筐。

不管是Claude Code源码逆向出来的各种机制,或者Hermes开源的自进化,以及Anthropic博客里讲的多sub-agent实现长程任务,本质上都在卷这一层。

Loop Engineering,2026 年中。 OpenClaw作者,Peter Steinberger和Anthropic Claude Code的负责人Boris Cherny几乎前后脚说了同一句话:

我不再 prompt Agent 了。我设计 loop,让 loop 去 prompt Agent。

这句话怎么理解?

简单理解就是,你不再亲自操作Agent,你应该设计一个让Agent自己运转的系统。

但是听起来有点抽象,什么叫“让Agent自己运转的系统”,那和现在OpenClaw、Hermes中支持的cron job又有什么区别?

在讨论这些问题时,我想再次梳理下这几个词的关系。

三个词之间的真实关系

Context和Harness之间,其实没有明显的边界。

今天业界总结出来的 Harness 手段,相当一部分本来就在管上下文,skill 渐进式披露是上下文,sub-agent 隔离是上下文,checkpoint恢复也涉及上下文重建。

Context Engineering可以算 Harness 的一个子集,至少高度重叠。

但 Loop 是真的另起了一层。

有的人觉得,Harness关心的是:一个Agent怎么跑不崩,能够正常完成任务。Loop关心的是:一堆Agent怎么被一个系统组织起来,自己跑、自己验证形成一个自循环。

这个并不是多Agent和单Agent之间的区别,Anthropic有篇比较经典的博客:

harness-design-long-running-appswww.anthropic.com/engineering/harness-design-long-running-apps

展示了怎么通过Harness,完成长程编程。里面用了三个Agent进行协作,一个负责计划,一个负责实现,一个负责评估。这不也是一堆Agent怎么被组织起来完成个任务么?

其实真正的区别是,任务的时间形态。

  • Harness服务于一次有限任务,人给一个任务,agent协作做完,然后整个系统退场。
  • Loop 服务于一项持续职能,没有终点,只有下一轮什么任务时候开始。

说白了,Harness有点像厨房里的工作,你要给厨师提供菜谱和合适的工具,然后厨房出一道菜,这个闭环就结束了。但Loop有点像开一个餐厅,你不亲自炒菜,你设计的是餐厅几点开门、厨房的工序怎么设计、菜单多久换一次、客人差评进哪个流程、库存少了谁补。

Loop更贴近所谓的自动化。

所以,你想直接上 Loop,需要先把Harness做扎实,这个又是另一个话题了。

这篇文章的范围

适合你:

  • 你知道这三个词,但说不清区别,总怀疑是不是换个壳在讲同一件事,那这篇文章能够一定程度上让你对他们边界的理解上一个台阶。
  • 你刚开始学习Agent,被这些短时间出现的名词反复轰炸,已经开始觉得只要不学,就不会落后。那么这篇文章至少能给你理顺这些概念。
  • 你看了Addy Osmani那篇Loop Engineering博客(https://addyosmani.com/blog/loop-engineering/),被里面反复提及的automations / worktrees / skills / sub-agents绕晕,想找一个形象的例子能对上号。那这篇文章会用实例讲解一下。

帮不了你,如果:

  • 你想要直接能运行的Loop Engineering代码示例,目前Github上有个小的实现,https://github.com/cobusgreyling/loop-engineering
  • 你如果就是觉得Agent圈这些名词是硬造词,凹概念。但你已经对这些落地方法烂熟于心了已经进入不滞于物,无招胜有招的境界,那么希望你帮我指正下这篇文章可能出现的错误。求大神带带我。

阅读推进路径

接下来四步:

  1. 回到 Context Engineering,看清楚这层解决的问题。
  2. 看Harness有哪些部分和Context Engineering不同,又是为了解决哪些问题落地了哪些方法。
  3. 拆解Loop Engineering,真正理解前面所说的区别在于完成任务的时间形态。
  4. 最后总结下,Loop Engineering到底是在凹了个新词,还是确实有些新东西。

读的时候牢记这句话,你每落地一层,你的决策权就会往上提高一层。

这是这三个词背后唯一重要的事,别的都是细节。


Step 1:上下文工程,让 Agent 看见该看见的东西

先回到第一层。上下文工程的核心命题是:Agent 的上下文窗口是一个稀缺资源,你得决定往里塞什么、不塞什么、塞的顺序。

具体来说,上下文工程要解决这三个问题,

第一个是信息选择。

你的代码库有十万行代码,Agent在当前这一步只需要看哪几段?

之前Agent工作中已经产生了大量中间过程数据,哪些数据对当前任务是有用的,哪些可以抛弃?

这是第一层自主权的边界。你决定了信息范围,Agent 在这个范围内自行发挥。

第二个是信息组织。

同样一堆信息,怎么排、怎么分块、用什么格式包装,Agent 的判断路径会完全不一样。

就拿位置来说,模型都有一个Lost in Middle问题,尽管目前模型支持的上下文窗口能达到百万级,但是中间的信息,依然容易被忽略。

那么,最重要的信息应该怎么放?

同时,各种模型的API接口,都支持Prompt Cache功能,如果你发送给模型的前缀能够命中Cache,那么会大大降低这次请求的成本。怎么在不改变前缀信息的情况下,合理组织重要的信息?

第三个是Tool和Context的关系。

Agent能调什么工具,决定它能自己拿到什么上下文。工具列表的设计本质上是上下文工程的延伸。

你通过控制工具来控制 Agent 能触达的信息边界。比如,你给Agent提供了“grep”工具,那么Agent就能自己通过调用这个工具,来获得合适的上下文。

这层做对了的标准是,Agent不需要你反复补充上下文就能正确理解当前任务范围。做错的表现是,Agent 反复问你已经说过的事,或者猜错你的意图然后越跑越偏。

上下文工程这层,你交出的是信息选择权。Agent 在给定上下文窗口内自主决定看什么细节、调什么工具。但你仍然保留每轮结束你检查结果,决定是否继续的权力。

Step 2:Harness工程,让Agent稳定完成任务

Harness的核心在于,能否让Agent稳定地完成长程任务?

这里面有两个部分,

第一个是,通过一定的工程手段,让能力相对较弱的模型,完成复杂任务。

第二个是,通过一定的工程手段,优化模型的完成任务路径,提升Agent的效率,或者降低Agent的成本。

业界这一年卷出来的Harness手段不少,Claude Code 的源码泄露后,里面各种各样的方法,Anthropic 自己也发过 harness design的博客,也有Hermes这种自进化的玩法。总结一下,本质上都在兜四类底。

第一种,还是管理上下文,对上下文进行的压缩、隔离、持久化

Agent跑长任务,上下文窗口迟早会遇到上限。那么与之而来的两个问题,怎么让之前的上下文进行无损保留,和损失相对较小的压缩?

Claude Code的做法是,进行结构化摘要,并不是自然语言叙述形式的摘要。把历史对话总结成已经做了什么、决定了什么、还剩什么没做的形式,再用这个压缩版替换原始历史。

Sub-Agent隔离,主Agent不去读一些较大的文件,比如超长日志、外部文档等,而是启动一个Sub Agent,来做重要信息的摘要,接着把这个摘要返回给主Agent。本质上就是把上下文窗口隔离开,避免脏数据,污染了主要工作的Agent的历史窗口。

持久化,有两种情况,第一种是持久化你的工作历史记录,第二种是持久化知识。工作历史记录完整地存储成JSON文件或者Markdown文件,如果摘要时候丢失重要信息,还能从这些原文件中重新获得原始信息,进行二次总结。持久化知识其实就是我们常用的Skill或者Claude.md文件,把解决任务中需要的稳定、复用率高的知识,例如代码规范、领域术语、踩坑记录等放进文档中,让Agent工作时放System Prompt中,或者渐进式加载。

这些方法实际上和上下文工程重叠程度很高,因为这些手段,仍然是在解决给模型“看什么”的问题。区别仅仅是,这些方法更加细化。

第二种,Agent 跑偏 ,卡死怎么办,进行循环检测,或者结构化计划

正如前文所说,Agent在某些工作时,容易陷入“复读机”的状态。一直使用重复的方法,来解决任务。导致空烧Token。这时候需要做的是及时进行介入,让Agent换个思路。

方法也有很多,比较经典的是,在Agent外,设计一个旁路监控,对Agent每轮的Action,进行监控。一旦发现反复几轮,调用了同样的工具,给工具传入了同样的入参。那么就注入一条信息,提醒Agent,已经重复了多轮,需要它换个思路。

这种软干预的方式很有用,Langchain在刷榜Terminal Benchmark 2.0时,给他们的Agent加了这个组件,然后提升了任务的成功率。

另外一个方法,就是所谓的结构化的计划,强制Agent在工作前,给自己先弄一个TODO List,每步照着List,逐一核对结果。Anthropic那篇长程编程的blog,实际上算是这个方式的进阶版,把单Agent中作计划这个过程,抽离出来,让一个子Agent去专门做这个事情。评估也是如此。

第三种,Agent如果跑崩了怎么办?设计checkpoint机制进行恢复

如果一个Agent跑任务,在某一步崩溃了,提前退出。没有checkpoint的话就需要重跑。但是有checkpoint的话,就能重新加载之前的工作进度,不用从头开始。这样相对来说能够省下一大部分时间和写的token。

第四种,Agent的权限控制

很多人在设计Agent时,会把一些关键指令放System Prompt中。比如“不要执行Delete操作”“不要执行rm -rf等等。但在Prompt中设计这些指令,对于LLM来说,只能算是一个软约束。你不能指望Agent每次都严格遵循这些指令。只要100次操作里,有1次没有遵循,那结果就是灾难性的。

所以,不管是Claude Code还是别的Agent,在设计时,都会增加黑白名单机制,作为硬约束。一旦检测到模型输出的tool call或者result,可能包含危险指令,要么直接中断,要么交由用户自己确认。

除了这四种,还有一种比较典型的Harness,就是修复LLM产生的错误工具格式,让Agent能正常调用工具。这些错误比较长尾。有一个典型的例子,就是CommandCodeAI CEO分享的,修复了DeepSeek V4 Pro的一些常见的工具调用格式问题后,在编程任务上性能能够超过原生的Claude Opus 4.7。

DeepSeek V4 Pro在工具调用时候有四种比较典型的错误,简单来说有:

  1. 可选字段传了 null 而不是省略它
  2. 把数组写成了长得像数组的字符串
  3. 调用格式期望数组,模型传了一个裸字符串
  4. 期望输入数组,模型传了一个空对象作为占位符

这些错误用了一百多行代码,通过规则进行修复。然后极大提升了基于DeepSeek V4 Pro的Agent的效果。

这层做对了的标准是,Agent 能在不用盯着的情况下,跑完一个跨几十步、跨多个工具调用的长程任务,中间不爆上下文、不陷入死循环(不是传统的死循环,而是上文说的复读机情况)、不做不可逆的危险操作,崩了也能从最近的 checkpoint继续工作。做错的表现是,上述的反面。

Harness工程这层,你交出的是单次运行内的过程控制权。Agent在你预设的安全边界里,可以自主决定调哪个工具、走哪条路径、什么时候该压缩历史、什么时候该拆sub-agent 去读外部信息。

但你仍然保留三件事的决定权:任务从哪里开始、安全边界划在哪里、以及碰到边界时是放行还是中断。

换句话说,上下文工程交出去的是看什么,Harness工程交出去的是怎么走。但什么时候出发、走到哪里算完成,这个限制还是在你手里,这部分权力要等 Loop 工程才会进一步交出去。

Step 3:Loop 工程,让系统自己去找 Agent 干活

到这一层,事情变了。Loop工程变成了一个更加宏观、系统的工程。

前两层你都还在用Agent,上下文工程是给 Agent 看什么,Harness 工程是给Agent设立规则让它稳定运行。但不管哪一层,启动按钮都还在你手里。你说一句任务描述,Agent帮你跑完,跑完停下来等你下一句指示。

Loop工程的核心命题是:你不再亲自启动 Agent,而是设计一个系统,由系统来决定什么时候启动 Agent、启动几个、产出谁来验、下一轮从哪接。

按Addy Osmani的拆法,一个能跑起来的loop由六件东西组成,五个基础组件加一个memory。值得一件一件看,因为每一件对应的都不是加一个功能,而是再往外交一层控制权。

第一件,Automations,交出什么时候开工。

手动跑Agent,是你决定什么时候按回车。Automation是让定时器决定,时间一到,它自己读昨天的CI失败、open issues、最近commits,自己决定今天该修哪个。Codex里有Automations标签,Claude Code里是 /loop、cron、生命周期 hook 或者 GitHub Actions,殊途同归。

更隐蔽的一层是/goal,你可以写一个判断条件比如“all tests in test/auth pass and lint is clean”。每一轮跑完,有一个独立的小模型在判断任务是不是已经完成,写代码的那个 Agent 不给自己打分。

真正交出去的不是调度权,而是判断什么时候算完成的角色由人变成了Agent。

第二件,Worktrees,交出并行 Agent 之间的协调。

跑超过一个 Agent编写代码,有个问题在于他们会制造代码冲突,这和两个工程师没互相协调就往同一行提交commit是一回事。git worktree给每个Agent一份独立的checkout,直接硬隔离让一个Agent的修改不会影响另一个的。

但Addy提醒过一句很要紧的话:worktree拿走的是机械冲突,不是你的review能力。能并行跑多少个Agent的天花板还是人,不是工具。

第三件,Skills,交出项目知识的分发。

Skill 这东西和Harness那一层是同一套机制,这层我认为不用多写,本质上无论是Harness中使用Skill还是Loop中使用,没有区别。无非就是Loop更强调多Agent共享同一套Skill。

第四件,Plugins / Connectors(MCP),交出loop 触达真实系统的能力。

Connector让loop能读issue tracker、查数据库、打staging API、往 Slack 扔消息。这是Agent仅返回修复建议和loop自己开 PR、关 ticket、CI 绿了往群里通知一声的区别。

这个层面的事情,其实也和传统的Agent没有什么区别。

第五件,Sub-agents,交出产出该不该结束任务的判断权。

这一层就是换一个有不同指令、不同模型的Agent来进行工作成果的review。和Anthropic那篇博客里最后单独设置一个Verifier Agent进行任务Review没有区别。但是Loop中,因为整个 loop 本身就是开放式、长程的,它评的是“当前进展够不够、要不要继续推进”,标准本身是浮动的,得由你亲自在Loop工程中,对reviewer Agent定义“够不够”的程度。

第六件,Memory / State,交出连续性。

这层方案和传统的记忆存储区别也并不是很大,方案可以很轻,拿一个Markdown文件,记录什么已经做过,什么没有做过的东西就行。

写到这里,你大概会有一个感觉:这六件,每一件看起来都和 Harness 里的某个东西高度重叠。

这个感觉是对的,而且这正是Loop工程最容易被误解的地方。

如果你把这六个组件单拎出来做技术对比,会发现Loop用的东西和Harness几乎完全一样,同样的 sub-agent、同样的skill、同样的MCP、同样的记忆持久化。Loop 没有发明任何一件新组件。可能顶多就是更自动化了?

但真正变了的不是组件本身,是这些组件被放进了一个不一样的时间结构里。

比如回到厨房和餐厅那个比喻。

Harness 里的sub-agent,是厨房里负责出品检查的人。这道菜出锅,他尝一次,味道好就继续出品,味道不好就重做。守的边界是这道菜。

Loop里的sub-agent,是后厨的厨师长。他要回答的问题不是这盘菜行不行,而是下一桌的菜什么时候上,今天的菜品哪个不受欢迎可以从菜单去掉。他守的不再是一道菜的质量,而是从整个营业时段的效果出发,进行任务的重新梳理,他做的判断完全不一样。

Harness里的所有组件,是为这一次任务从开始到结束服务的。任务来了,sub-agent 干活、verifier 验收、checkpoint 兜底,跑完整个harness就退场。整个harness像一条流水线,工件进、成品出,工件没了流水线就停。

Loop里的所有组件,是为这条产线永远不停服务的。Automation在替你决定什么时候开始,sub-agent 在替你决定这一轮的活儿够不够好、要不要再来一轮,state/memory在替你记住昨天做到哪了、今天该接着干什么、上周哪个pattern反复出问题。整个loop更像一个常驻进程,它不是为某个具体任务存在的,它是为某项持续职能存在的。

这层做对了的标准是,系统能在你不参与的情况下持续运转,你只需要每隔一段时间去看一下STATE.md里它都做了什么、有什么没决定的事情升级给你了。

Loop工程这层,你交出的是任务的发起权和验收权。Automation替你决定开工时机,sub-agent里的reviewer替你决定一轮工作够不够格,memory/state替你维护跨轮次的连续性。你保留的只剩两样东西:

  1. 设计权:loop本身怎么设计,什么pattern、什么运行节奏、谁review 谁、哪些动作需要人工confirm、哪些可以自动merge。
  2. 升级裁决权:loop自己处理不了、扔到你面前的那些case,由你来做最后判断。

到这一层,你在日常工作中出现的频率应该是肉眼可见地下降的。如果你发现自己还是天天在循环里被cue,那说明这个loop要么设计有问题,要么还没到该上Loop这层的成熟度。


Step 4:那 Loop Engineering 到底是不是凹了个新词

回到一开始那个问题:这三个词是不是同一件事换了三个壳?

我自己梳理完一圈下来的结论是:组件层面高度重复,但决策层级实打实地往上挪了一层。

把三层叠在一起看,最清晰的就是你交出去了什么这条线:

每往下一层,人这个角色在日常工作流里出现的频率就下降一档,而设计这套系统的难度和后果,则上升一档。这才是Loop Engineering 不是凹词的关键,它确实对应了一个新的工程位置,但前提是你愿意承担与之匹配的责任。


绕了一大圈,回到最开头那句话:

你每落地一层,你的决策权就会往上提高一层。

Context Engineering 让你从在prompt里写细节升级到设计给Agent提供信息边界。Harness Engineering让你从设计信息边界升级到设计任务执行的安全护栏。Loop Engineering让你从设计单次任务的护栏升级到设计一项持续职能的运转方式。

这三层是叠加关系,不是替代关系。你不可能跳过Context和Harness这两步直接做 Loop,就像你不可能跳过菜谱和厨房直接开餐厅。但如果你把Context和Harness都做扎实了,Loop这一层就是把你这个人从按回车的人变成设计为什么按回车、什么时候按、谁来按的人。

至于这算不算真正的新东西,我的答案是:组件不算新,位置是新的。而位置变了,工程上要回答的问题就全变了。这就够了,不必非得发明新的组件才叫进步。

作者:酱紫君
链接:https://www.zhihu.com/question/2048003050531558553/answer/2048094419505746085
来源:知乎
著作权归作者所有。商业转载请联系作者获得授权,非商业转载请注明出处。

又开始造词了,有币圈那味了。

从 Vibe Coding 开始,ReAct 范式、spec driven、wish coding、harness 工程、loop 工程,这都第几个了。

拨开 AI 黑话,其实很简单。

Spec 就是给 AI 看的 PRD,Harness 就是给 Agent 用的 Framework,Loop 就更简单了,其实就是 CI。


什么叫 Loop 工程呢,根据 AI 造词仙人的定义,大致就是这样一个流程:

  1. 跑个脚本,抓取最新的 Bug 列表。
  2. 丢给大模型,让大模型改代码。
  3. 改完后,系统自动运行单元测试。
  4. 如果测试没过,把 Error 堆栈抓出来叫大模型继续改。
  5. 循环这个过程,直到测试全部变绿,提交 PR。

这个过程好像似曾相识啊,你说是不是啊,D 指导?


AI 圈目前所有的工作流创新,本质上都在做一件事:

用大语言模型,把十多年前 DevOps 思想下的 CI/CD 管道全™重新发明一遍。

古法编程是怎么配 Jenkins/GitHub Actions 的?

  • 触发机制:开发 Push 了代码,触发 Webhook
  • 隔离环境:为了不污染宿主机,起一个干净的 Docker 容器
  • 执行任务:在容器里跑 npm install
  • 验证反馈:跑 ESLint 检查代码规范,跑 Jest 单元测试
  • 全绿:打个 Tag,飞书群通知完工
  • 红了:飞书里直接骂那个提交代码的人,让他滚回去改

AI 仙人所谓的 Loop 工程新法开发呢,也是一样的:

  • 触发机制:Cron Job 定时任务,或者 GitHub 上的新 Issue
  • 隔离环境:哦,他们造了个新词,叫 Worktree 沙箱,其实还是个 Docker 容器
  • 执行任务:不再跑固定的 CI 脚本,而是烧 Token 叫 Agent 读 Skills 执行
  • 验证反馈:依然是 ESLint/Jest,这一步完全没有 AI,看来还是有点脑子的,我还以为会叫 AI 一行一行检查呢
  • 全绿:AI 打个 Tag,飞书群通知完工
  • 红了:编辑器里直接骂大模型,让它滚回去改

再这样下去,过段时间,AI 造词仙人就要重新发明 CD 了。

持续交付、灰度发布、混沌工程,这些老词不知道能被他们编出来些什么新的花样。

动图封面

学习,学个屁,本来就没什么新东西。


商业需要故事,VC 需要概念,所以就只能没活硬抄(不是炒)。

应用层的 AI 开发者实在是想不出什么新花样了,只能转头去翻翻经典的计算机体系结构、翻翻 DevOps 教科书、翻翻控制论。

把里面的方法论全抄过来,裹上一层 AI 的糖衣,当成伟哥卖给大众。

如果你跟着他们的节奏陪跑,你就会累死,觉得自己是个铁废物,前面的还没学会后面又来了。

反之,静静坐下,让子弹飞一会儿,笑看 AI 仙人的小丑行为,等他们把这些脑残的黑话都造完,把泡沫吹破就行。


只要你学得够慢,你就可以什么都不用学。

Codex中必装的11个Skills

前言

你有没有遇到这样的场景:让AI帮你写一个功能模块,代码确实写出来了,“看起来没问题”,但一上线就炸了——边界条件没处理、异常捕获缺失、甚至还有SQL注入风险。

如果你正在用Codex或其他AI编程Agent,你一定对这些痛点感同身受:AI写的代码“看起来能跑,一上线就炸”、多步任务时上下文一长就失忆、Token消耗飞快不知道怎么优化、想让AI学会调用外部服务却不知道如何下手……

这就是Skill出现的根本原因。

2026年,Codex从单纯的代码补全工具,进化为具备自主执行能力的编程Agent。

而Skills作为Agent能力扩展的核心机制,将复杂任务拆解为可复用的原子能力,其渐进式加载机制能够节省80-95%的Token消耗。

今天这篇文章,我就手把手带大家梳理Codex中最值得安装的11个Skills,从安装配置到底层原理,从实战效果到优缺点,一篇搞定。

希望对你会有所帮助。

最近想快速提升项目实战能力(包含多个AI项目),或者最近找工作的小伙伴,可以看看下面 的这个链接(或许真的能够帮到你):http://susan.net.cn/project

最近建了几个AI技术交流群,扫描加我微信:li_su223,备注:AI,即可进群交流和学习,获取AI最新咨询。

一、什么是Codex Skills?

在开始之前,先快速科普一下Skills是什么。

Codex Skills是一套以SKILL.md文件为核心的指令包。

Codex启动时,会读取所有已安装Skill的名称与描述(大约只占2%的上下文预算),当你发起任务时系统自动匹配并加载对应Skill的完整指令。

如无匹配,则不占用任何上下文,非常高效。

更重要的是,Skills格式是开放标准——同一份SKILL.md无需修改,就可在Codex CLI、Claude Code、Gemini CLI、Cursor以及GitHub Copilot等主流AI编程工具中通用。

Skill存放有三个作用域:

Skill触发方式有两种:显式调用(在CLI中输入$skill名称)和隐式触发(任务描述与Skill描述自动匹配时自动激活)。

最近想快速提升项目实战能力(包含多个AI项目),或者最近找工作的小伙伴,可以看看下面 的这个链接(或许真的能够帮到你):http://susan.net.cn/project

二、如何安装Skills?

安装Codex Skill主要有三种方式:

方式一:手动克隆安装(适合所有Skill)

将Skill仓库克隆到Codex的Skills目录即可:

# 创建Codex技能目录
mkdir -p ~/.agents/skills

# 克隆Skill到该目录下(以superpowers为例)
git clone https://github.com/obra/superpowers.git ~/.agents/skills/superpowers

# 如果使用Codex App,某些版本也可能需要同步到.codex/skills
mkdir -p ~/.codex/skills
cp -r ~/.agents/skills/superpowers ~/.codex/skills/

方式二:官方skill-installer工具(推荐)

OpenAI官方提供了一套通过$skill-installer命令安装的机制。对于官方技能库中的Skill,可以直接用该工具安装:

# 安装官方技能
$skill-installer <skill-name>

# 安装实验性技能
$skill-installer install https://github.com/openai/skills/tree/main/skills/.experimental/<skill-name>

方式三:使用社区自动化工具

社区提供了多种自动化安装工具,覆盖不同的安装来源和需求:

工具安装方式适用场景
@supercorks/skills-installernpx @supercorks/skills-installer install一键安装技能,支持Git稀疏检出和Codex Agent转换
@sstar/skill-installskill-install install [URL或本地文件] –tool codex支持公开URL、Wiki、本地文件,自动解压验证
@goodpostidea-tech/skillsnpx @goodpostidea-tech/skills add [repo-url] –skill [name]从任何GitHub仓库安装,交互式选择工具
@bbhxwl/skillsnpx @bbhxwl/skills install [name] –target codex从Registry安装,支持更新和卸载

以@supercorks/skills-installer为例,完整安装流程如下:

# 运行安装器
npx @supercorks/skills-installer install

# 交互式选择:
# 1. 选择安装类型(skills / subagents / both)
# 2. 选择安装路径(全局或本地)
# 3. 交互式勾选要安装的技能
#    - 使用↑/↓导航
#    - 使用SPACE切换选中
#    - 使用→展开加载描述
#    - 使用A全选
#    - ENTER确认

安装完成后,执行codex restart使新技能元数据生效——该命令会清空当前会话缓存并重载SKILL.md中定义的触发关键词和前置条件。

💡 技巧:如果希望所有AI工具共享同一个Skill目录,可以用软链接实现。Codex默认不自动读取.claude/skills,可以通过以下命令统一管理:ln -s ~/.claude/skills ~/.agents/skills

三、去哪里寻找更多Skills?

Codex Skills生态已经相当丰富,以下是最值得关注的官方Registry和资源库:

Registry特点访问地址
TokRepo500+技能,支持中文,社区投票排序,一键安装命令https://tokrepo.com
Anthropic官方SkillsSKILL.md规范参考实现https://github.com/anthropics/skills
VoltAgent/awesome-agent-skills社区整理的Awesome列表,含官方技能https://github.com/VoltAgent/awesome-agent-skills
OpenAI Codex Skills CatalogCodex官方技能目录https://github.com/openai/skills
ComposioHQ/awesome-codex-skillsComposio整理的Codex精选技能https://github.com/ComposioHQ/awesome-codex-skills
SkillsMP70万+技能,智能过滤https://skillsmp.com

如果只想快速上手,试试一条命令批量安装:npx antigravity-awesome-skills --codex(需要先安装antigravity-awesome-skills工具包)。

四、11个必装Skills

下面这个架构图可以帮助你快速了解各个Skill在整个开发流程中的定位,以及它们之间的层次关系:

下面一个一个来说,每个Skill都会附上开源地址和安装命令。

Skill 1:create-plan

它告别“Prompt First乱写”。

开源地址: https://github.com/openai/skills/tree/main/skills/.experimental/create-plan

安装命令:

# 官方安装
$skill-installer install create-plan

# 或从LobeHub安装
# 访问 https://lobehub.com/skills 搜索create-plan

一句话说清楚: 强制Codex在写任何代码之前,先拆解任务、输出可审阅的执行计划。

很多小伙伴在工作中可能会遇到这样的情况:给Codex一个复杂的任务,比如“帮我把这个单体应用的后台管理模块改成微服务架构”,然后它就埋头开始写了。

写了一半你发现路径错了,改一遍Prompt,它又从零开始。再改一遍,Token消耗了几万,任务还是没完成……

create-plan通过在写代码前强制AI输出可审阅计划,从根本上解决了“prompt-first乱写”的问题。

安装后,当你向Codex描述需求,它会先输出一个结构化的执行计划(格式化为<NAME>_PLAN.md),让你确认后再开始写代码。

就像真实架构师的日常工作步骤:先设计方案,评审通过,再开始编码。

从Codex 1月的更新起,create-plan已部分内置到Codex CLI中,Shift+Tab即可在Plan和Code模式之间自由切换。

  • 优点: 大幅减少返工,确保大方向正确后再执行;对所有复杂任务都有效
  • 缺点: 多一次确认步骤,高频简单任务会稍显繁琐
  • 适用场景: 多文件、多模块的中大型任务;需要多人协作审阅方案的项目

最近想快速提升项目实战能力(包含多个AI项目),或者最近找工作的小伙伴,可以看看下面 的这个链接(或许真的能够帮到你):http://susan.net.cn/project

Skill 2:Superpowers

它让AI像严格工程师一样工作。

开源地址: https://github.com/obra/superpowers

安装命令:

# 方法一:直接克隆
git clone https://github.com/obra/superpowers.git ~/.agents/skills/superpowers

# 方法二:使用npx安装器
npx @supercorks/skills-installer install
# 然后在交互界面中勾选superpowers

# 方法三:使用skill-install工具
skill-install -t codex install https://github.com/obra/superpowers/archive/main.zip

安装后必须重启Codex,因为Superpowers依赖会话启动时的钩子来完成技能发现与注入。

社区热度最高(90k+)的Skills框架。

核心问题:如何避免AI写出“看起来能跑、实际上有坑”的代码?Superpowers的核心理念是强制TDD(测试驱动开发)+ 自动代码审查。

它内部包含了14个技能(Skills)和1个代理(Agent),在Codex写任何功能代码之前,先要求它生成测试用例;写完代码后,主动执行代码审查。

这种“先测试、后实现、再检查”的流程,能显著减少逻辑漏洞和边界条件遗漏。

Superpowers的工作流程覆盖了完整的开发链路:brainstorming(头脑风暴)→ writing-plans(编写计划)→ test-driven-development(测试驱动开发)→ subagent-driven-development(子代理开发)→ requesting-code-review(请求代码审查)→ verification-before-completion(完成前验证)→ finishing-a-development-branch(完成开发分支) 。

每个阶段都有专门的技能保障质量。

  • 优点: 代码质量大幅提升;主动发现边界条件和异常处理;减少后期调试成本
  • 缺点: TDD流程会增加一定Token消耗;不适合原型快速验证场景
  • 适用场景: 生产级业务代码开发;需要有测试覆盖率的项目;核心功能模块开发

Skill 3:gh-fix-ci

它能将20分钟的CI排查压缩到几秒钟。

开源地址:

官方Skill – https://github.com/openai/skills/tree/main/skills/gh-fix-ci

社区版 – https://github.com/davila7/claude-code-templates

安装命令:

# 官方安装
$skill-installer install gh-fix-ci

# 从LobeHub安装
# curl https://lobehub.com/skills/composiohq-awesome-codex-skills-gh-fix-ci/skill.md
# 然后按照提示完成安装配置

# 从Community Registry安装
npx @bbhxwl/skills install gh-fix-ci --target codex

解决问题: GitHub Actions失败排查耗时耗力。很多后端和DevOps工程师每周可能要花几个小时在排查CI失败上。

gh-fix-ci会自动读取失败的GitHub Actions运行记录,汇总错误原因并给出具体修复建议。

这是一个非常巧妙的Skill,它把“AI读取错误日志 → 理解失败原因 → 分析相关代码 → 定位问题根源 → 给出修复方案”这条链路完全自动化了。

Skill内部执行了8步结构化流程:验证gh CLI认证状态 → 识别失败的PR检查 → 提取失败日志 → 区分GitHub Actions内外部范围 → 汇总失败摘要 → 请求用户批准修复方案 → 实施修复 → 推回验证。

  • 优点: 把原本20分钟的CI排查压缩到几秒钟;自动识别多类型错误;输出结构化
  • 缺点: 必须GitHub Actions用户,需要正确配置GitHub集成;需要本地安装gh CLI
  • 适用场景: 频繁使用GitHub Actions的后端/全栈/DevOps开发;多人协作项目;上线前质量保障

Skill 4:frontend-skill

它让AI帮你设计好看的页面。

开源地址: https://github.com/anthropics/skills/tree/main/skills/frontend-design

安装命令:

# 从官方Anthropic仓库安装
git clone https://github.com/anthropics/skills.git ~/.agents/skills/anthropic-skills
# 然后进入~/.agents/skills/anthropic-skills/skills/frontend-design 即可使用

# 或使用TokRepo一键安装
npx tokrepo install frontend-design

纯前端或者全栈开发者应该最有感触:Codex默认生成的前端页面,功能是能跑,但样式简直“复古”。

frontend-skill将设计规范和组件风格编码进指令,让Codex生成更具设计感的前端页面。

核心解决的是“懂功能不懂设计”的问题。Skill内部封装了常见的设计原则(间距、色彩、字体、圆角、阴影)以及现代UI框架的组件模式,让AI在生成页面时自动应用。

Skill的核心目标是避免生成千篇一律的“AI风格”界面,而是通过在设计上有意地选择大胆、明确的美学方向(例如:极简、复古、未来感、野兽派等),并注重排版、色彩、动效、空间布局等细节,来打造出令人印象深刻、具有艺术感的前端页面。

  • 优点: 颜值提升显著;可无缝配合其他设计Skill使用
  • 缺点: 部分复杂自定义设计仍需人工干预
  • 适用场景: 前端/独立开发快速构建后台、营销页等;没有专业设计师的资源团队

最近想快速提升项目实战能力(包含多个AI项目),或者最近找工作的小伙伴,可以看看下面 的这个链接(或许真的能够帮到你):http://susan.net.cn/project

Skill 5:webapp-testing

它能自动化的Web应用测试。

开源地址: https://github.com/openai/skills/tree/main/skills/webapp-testing

安装命令:

$skill-installer install webapp-testing

核心价值: 针对Web应用执行自动化测试并汇总结果报告。

webapp-testing基于Playwright浏览器自动化框架,能够模拟用户交互行为,包括点击按钮、填写表单、验证登录/退出链路以及捕获控制台报错。

其核心优势在于允许开发者使用自然语言描述测试场景,系统自动生成脚本并执行测试,最终返回结果与截图留证。

Skill会自动识别项目使用的测试框架(Jest、Mocha、Playwright、Cypress),生成的测试用例风格与现有测试保持一致,无需额外清理。

具体工作流程:Skill会先扫描项目根目录及package.json,检测已安装的测试框架,读取现有测试文件的命名模式和代码风格,然后生成风格一致的新测试用例。

最后执行测试并汇总报告,以结构化方式展示通过/失败情况、失败原因和建议修复方案。

  • 优点: 保持项目已有测试风格一致性;适用于任何Web技术栈
  • 缺点: 项目需要已配置测试框架;复杂集成测试仍需人工补充
  • 适用场景: QA工程师和全栈开发者的日常;项目有测试覆盖率要求的CI流程

Skill 6:mcp-builder

它是高质量的MCP Server构建向导。

开源地址: https://github.com/openai/skills/tree/main/skills/mcp-builder

安装命令:

$skill-installer install mcp-builder

MCP(Model Context Protocol)是2024年发布的开放标准,其核心价值在于建立模型与外部系统的标准化通信通道,解决M×N集成难题。

mcp-builder通过四阶段工作流(规划→实现→评估→优化) 引导构建符合最佳实践的MCP Server,确保每个MCP Server都能获得高质量的工具定义、合理的错误处理和良好的用户体验。

四阶段解释:

  • 规划: 理解数据源/API,确定需要暴露哪些Tools、Resources和Templates
  • 实现: 基于MCP SDK构建Server,支持Python(FastMCP)或Node/TypeScript(MCP SDK)
  • 评估: 测试工具是否按预期工作,响应格式是否正确
  • 优化: 迭代改进性能和处理逻辑

MCP Server的质量衡量的标准是:它能在多大程度上帮助大模型完成真实世界中的任务。

  • 优点: 标准化流程防止遗漏;代码质量和可维护性有保证
  • 缺点: 四阶段流程对简单Server可能稍显重
  • 适用场景: 正在构建AI Agent接入外部API的开发者;需要标准化工具集的项目

Skill 7:brooks-lint

它能做代码规范自动化审计。

开源地址: https://github.com/hyhmrright/brooks-lint

安装命令:

# 方法一:直接克隆
git clone https://github.com/hyhmrright/brooks-lint.git ~/.agents/skills/brooks-lint

# 方法二:使用CLI安装
npx @bbhxwl/skills install brooks-lint --target codex

来自社区hyhmrright/brooks-lint的审计类Skill,与普通的代码审查工具不同之处在于——brooks-lint从六本经典软件工程书籍中提炼出6个衰退风险维度,对代码进行结构化诊断:

书籍审查维度
《人月神话》(Brooks)概念完整性、沟通开销
《代码大全》(McConnell)代码可读性、构建实践
《重构》(Fowler)代码异味、设计腐化
《整洁架构》(Martin)架构边界、依赖原则
《程序员修炼之道》(Hunt & Thomas)务实编程、关注点分离
《领域驱动设计》(Evans)领域模型完整性

集成了多种编程语言的代码规范检查,能够扫描Pull Request变更,基于项目既定规范检测代码格式、命名、注释等合规性问题,并直接给出违反规则的具体位置和修复指引。

触发方式很灵活:可以在GitHub Actions中作为CI Job自动执行,也可以在本地Git Hook中作为提交前的质量把关。

  • 优点: 对代码规范的高效自动把关;可嵌入CI/Hook流程;权威书籍驱动的深度诊断
  • 缺点: 需正确配置项目规则集才能达到理想效果
  • 适用场景: 需要统一代码风格的团队;代码审查流程的标准环节

最近想快速提升项目实战能力(包含多个AI项目),或者最近找工作的小伙伴,可以看看下面 的这个链接(或许真的能够帮到你):http://susan.net.cn/project

Skill 8:pr-review

它是AI驱动的PR自动审查。

开源地址: https://github.com/openai/skills(官方Skill目录)

安装命令:

$skill-installer install pr-review

当代码提交PR时,Codex会自动扫描变更文件并输出结构化问题报告,无需人工干预。它支持多维度分析:功能正确性、架构合理性、安全漏洞等,并能结合多个AI(Claude、Codex、Gemini)进行全面的PR审查。

触发方式:通常通过GitHub Actions自动触发(on: pull_request: types: [opened, synchronize, reopened]),Codex会读取变更文件的diff,检查空指针、资源泄漏、API兼容性、安全漏洞等多个维度,最后输出结构化的审查报告。

报告可直接作为PR评论呈现。

  • 优点: 大幅减少人工Code Review工作量;7×24小时随时可用
  • 缺点: 需正确配置自动化触发流程;复杂业务逻辑可能需要人工介入
  • 适用场景: 多人协作项目的日常PR流程;团队Code Review效率优化

Skill 9:Planning-with-Files

它能将Markdown当外挂记忆库。

开源地址: https://github.com/OthmanAdi/planning-with-files

安装命令:

# 方法一:使用plugin marketplace(如果使用Claude Code,Codex同理映射到.agents/skills)
/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-files

# 方法二:手动安装
mkdir -p ~/.agents/skills/planning-with-files
curl -L -o skill.zip "https://mcp.directory/api/skills/download/593"
unzip -o skill.zip -d ~/.agents/skills/planning-with-files
rm skill.zip

Skill体系的一大核心优势在于渐进式加载机制。

AI主上下文只用2%预算读Skill摘要,真正的领域知识按需加载,不会烧爆上下文窗口。

Planning-with-Files把这个机制发挥得淋漓尽致,它利用Markdown文件给AI当“外挂记忆库”。

AI可以在执行过程中将中间结果、决策记录、待办事项写入Markdown文件,在后续步骤中随时读取。

这个机制的深层价值在于:当任务链条长到单次对话Token不够时,Markdown文件充当了可持续读写的外置记忆。

Skill会创建并维护三个文件:

  • task_plan.md — 任务拆解和整体规划,记录阶段进度和决策
  • findings.md — 调查发现和中间结论,记录每次会话的操作和错误
  • progress.md — 当前进度和已完成步骤

最实用的地方在于:执行/clear清空上下文后,Codex能从这些文件中完整恢复状态,不会丢失之前的工作进展。

对于跨多个会话的大型功能开发来说,这个特性非常关键。

  • 优点: 突破单次对话的上下文限制;长流程任务的执行力大大提升
  • 缺点: 文件读写操作有一定I/O开销
  • 适用场景: 需要多轮交互的大型重构/开发任务;AI执行进度可追溯性要求高的场景

最近想快速提升项目实战能力(包含多个AI项目),或者最近找工作的小伙伴,可以看看下面 的这个链接(或许真的能够帮到你):http://susan.net.cn/project

Skill 10:DocumentSkills

它拥有强大的文档解析能力。

开源地址: https://github.com/anthropics/skills(Anthropic官方Skills仓库)

安装命令:

# 克隆官方仓库
git clone https://github.com/anthropics/skills.git ~/.agents/skills/anthropic-skills

# 然后在skills/document-skills目录下即可使用PDF、Word、Excel、PPT解析功能

# 或通过/plugin marketplace安装
/plugin marketplace add anthropics/skills/plugin
/plugin install document-skills@anthropic-agent-skills

支持在Codex侧边栏直接打开PDF、Word、Excel等文档并预览。

底层技术基于大模型的文档解析能力,将非结构化文档内容转化为AI可理解的结构化数据。

当你需要让Codex理解一份产品需求文档、API文档或技术设计说明书时,DocumentSkills会让AI“看懂”并基于文档内容执行任务。

该Skill来源于Anthropic官方仓库,是为开发者处理大量技术或需求文档而设计的。

  • 优点: 扩大AI的知识来源,不局限于代码库;文档驱动的开发工作流
  • 缺点: 文档格式的复杂程度影响解析准确率
  • 适用场景: 基于需求文档自动生成代码;处理现存项目的技术文档

Skill 11:Context-Engineering

它教会AI管理自己的上下文。

开源地址: https://github.com/openai/skills(实验性技能)

安装命令:

$skill-installer install context-engineering

AI在工作时对自身Token消耗和上下文状态是“无知”的,Context Engineering Skills就解决了这个问题,包含对上下文的监控、压缩、优先级管理等核心能力。

技术机制:在任务执行过程中持续监控Token使用量,当接近上限时,主动压缩或摘要化非核心上下文内容;在高优先级任务前确保关键上下文不被挤出窗口。

对长期运行的Agent来说,这个Skill可以帮助避免“掉链子”。

Antigravity-awesome-skills中的Context Engineering Suite包含了7个完整的上下文管理工具。

  • 优点: 减少长对话中的“失忆”现象;自动优化Token使用
  • 缺点: 压缩策略可能导致部分信息的丢失
  • 适用场景: 长时间运行的AI任务;需要精细化成本控制的AI使用场景

最近想快速提升项目实战能力(包含多个AI项目),或者最近找工作的小伙伴,可以看看下面 的这个链接(或许真的能够帮到你):http://susan.net.cn/project

五、底层原理

上述Skills之所以能带来如此显著的效率提升,得益于背后的Skill体系设计。

我们可以通过这张流程图,清晰地看到Skill的完整工作链路和技术实现:

这个流程中最关键的技术点在于:渐进式加载机制。

Skill体系通过“2%预算预览+按需加载”的模式,在保证AI具备足够上下文知识的同时,大幅降低了Token消耗。

来看一个实测对比:用传统Prompt处理10万次客服咨询,Token消耗约15M;用MCP方案降至约12M(含协议开销约1.5M);用Skill方案通过知识压缩,Token消耗可降至2-3M,相当于节省80-90%。

此外,MCP协议定义了模型与外部系统交互的标准——支持JSON-RPC 2.0通信、采用客户端-服务器模式。

当Skill需要外部数据时,MCP负责将数据库查询结果或API响应转换为模型可理解的JSON格式,极大简化了AI调用外部服务的过程。

Skill系统的加载机制同样值得关注:Codex会在启动时执行BFS广度优先遍历,向上搜索最多6层目录,全局最多访问2000个目录查找SKILL.md文件。

这一设计在保证Skill可发现性的同时,控制了扫描开销。

最近想快速提升项目实战能力(包含多个AI项目),或者最近找工作的小伙伴,可以看看下面 的这个链接(或许真的能够帮到你):http://susan.net.cn/project

六、优缺点和使用建议

优点:

  • Token高效利用,核心知识渐进式加载,相比传统Prompt可节省80-95%
  • 知识可沉淀,Skill本质上是“可执行的领域知识”,经验可复用、版本可控制
  • 技能可组合,任意调用多个Skill协同完成复杂任务
  • 输出一致性高,通过知识固化可将输出一致性提升300%
  • 跨平台通用,同一SKILL.md可用于Codex、Claude Code、Cursor等工具

缺点:

  • 需要学习和建设,初期花时间了解Skill配置和推荐清单
  • 质量良莠不齐,建议从社区高热度/官方Skill开始,避免“Skill堆砌”
  • 部分场景不如直接Prompt灵活,高度定制化任务时反而增加步骤

适用场景推荐:

记住两个关键原则:

  • 不是越多越好,而是越“对”越好。
  • Skill不是替代人工思考,而是放大你的思考效率。

总结

如果说2024年是MCP“协议元年”,那2026年就是Skills“应用爆发之年”。

Skill体系通过“专家知识封装+渐进式加载”的设计理念,为AI Agent提供了强大的能力扩展机制。

从最初的自定义Skill开始,到如今社区已有基于awesome-agent-skills索引、包含数千个Skill的庞大生态。

上文的11个Skills是我经过半年多实战筛选出的“真·必装”清单。

建议的安装路径:先装create-plan体验任务拆解,再装Superpowers让TDD和代码审查成为AI的新习惯,然后按需添加gh-fix-ci、frontend-skill等针对性Skill。

搭配planning-with-files和Context-Engineering两基友,即便是跨数天的大型重构任务,AI也能高效完成、不掉链子。

最后,送大家一句话:Skill用得好,AI从“什么都能答”的实习生,秒变“什么都懂行”的资深架构师。

如果觉得今天的分享对你有帮助,点个在看,转发给更多需要提升效率的小伙伴!

最近想快速提升项目实战能力(包含多个AI项目),或者最近找工作的小伙伴,可以看看下面 的这个链接(或许真的能够帮到你):http://susan.net.cn/project

送礼物

Obsidian文件命名规范

用Obsidian久了,笔记一多,找文件就变成噩梦。

文件名记不住,文件夹越挖越深,点开七八个才找到想要的内容——这不是工具不好,是命名没做好。

最近整理了一套自用的文件命名规范,用了一段时间,确实比之前清爽太多。今天分享出来,照着做就行。

一、命名是导航,不是标签

好文件名和差文件名的区别在哪?

差文件名:读书笔记、待处理、新建文档2

好文件名:20250315-产品需求文档-小红书运营-V1.0-@蛋仔成长笔记-已完成

后者看起来信息量更大,但用起来有多爽,谁用谁知道:

  • 查找快:不用点开文件夹扫一眼就知道是不是要找的文件
  • 排序有用:按时间、按类型排序,一眼看到最新内容
  • 批量操作方便:脚本处理、批量重命名都能实现

文件命名不是什么高阶技巧,就是怎么让找文件更快。

二、推荐格式

文档类型-主对象-子对象-所属业务-版本-更新时间-更新人-状态

示例:需求文档-进度计划系统-计划编制-智能建造-V1.0-20251201-@Cloud-未完成

拆开看

字段含义示例
文档类型文件类别需求文档、项目计划书、研究报告
主对象核心内容系统、主任务如:进度计划系统、施工日志、工作总结
子对象细分内容功能、子任务具体章节或专项
所属业务归属项目/领域如:智能建造、智慧城市、XXX项目
版本当前版本V1.0、V0.3
更新时间最后修改时间20251201
更新人修改者@Cloud、@蛋仔成长笔记
状态当前进度未完成、评审中、已完成

版本号规则:

  • 0 = 草稿
  • V0.1 = 草稿第一版
  • 评审修改一次 +0.1
  • 交付完成 +1 → V1.0、V1.1

这套格式覆盖了文件的核心信息,查找时一眼就能定位。

三、分隔符:用短横线,别用下划线

分隔符:用短横线,别用下划线

统一用 -,别混用 _。

理由:

  1. 日期格式一致:2025-03-15 本身就是短横线,拼在一起不违和
  2. Dataview处理方便:split(file.name, “-“) 直接拆字段
  3. URL友好:分享链接时,地址栏显示更清晰

下划线不是不能用,但只限于特定场景:

  • 代码笔记:文件名本身是代码变量名,比如 data_structure-算法笔记
  • 强调整体模块:Data_Analysis-项目A,下划线表示这是一个整体

核心原则:全库统一。要么全 -,要么全 _,别混。

四、两条铁律:小写 + 日期前缀

1. 全部小写

防止 macOS 和 Windows 大小写敏感导致的路径问题。统一小写最稳妥。

2. 日期前缀

日常笔记用日期开头,如:20250315-工程数字化需求分析.md。

按时间排序,所有笔记自动排成一列。找最近的内容,看第一行就知道。

五、特殊符号标记

用【】表示以内容为主,无实效性的长期的笔记。

例如:MOC、指标、方案、规范、标准、报告

示例:【指标】集中式光伏电站智慧工程指标

用【】表示带有时间属性笔记。

例如:会议、任务。

示例:20250622【会议】关于战略、商业模式的讨论

六、现在开始

不用一次性改完所有旧文件,从新创建的文件开始用就行。

几个建议:

  • 新文件套模板:每次新建文件时,按格式来,养成习惯
  • 同类文件统一格式:同类型的文档用同样的结构,别各搞各的
  • 关键信息不能少:可以简洁,但版本、时间、状态这些字段别省略
  • 每月检查10分钟:定期看看命名是否跑偏,及时调整

规范本身不难,难在坚持。用久了就习惯了,你的Obsidian会明显比之前好找东西