ESSAY
从理念到工具：打造 SOP-Creator.skill 的实践
“理论是灰色的，而生命之树常青。把约束理念转化为物理门禁，才是对概率系统最完美的降维打击。“
核心观点 / 起源
在上一篇《给概率系统加上确定性》中，我提出了 VibeCoding 的四大法则：约束至上、输入输出标准化、状态流转机制和内置降级反思。但理念终归是理念，如果不能落地为可复用的工具，它就只是一篇”正确的废话”。
当我看到 skill-creator 的工程目录结构（SKILL.md + scripts/ + references/）时，突然意识到：这不正是 VibeCoding 中”记忆外包”和”状态持久化”的完美物理载体吗？于是我决定打造 sop-creator.skill——一个能够基于个人工作流自动生成 SOP 的元工具。
为什么这两者是天作之合？
skill-creator 提供的目录结构，正好可以承载 VibeCoding 的核心机制。通过 Progressive Disclosure（渐进式披露），把重度背景知识拆分到 references/，只在 SKILL.md 中保留触发条件和状态流转逻辑，能极大节省 Token，保持 AI 的专注力。而 skill-creator 强调的”设定适当的自由度”，与 VibeCoding 中”规定 AI 绝对不能做什么”的理念不谋而合。
核心设计思路
强制状态机定义
每个 Skill 都必须包含严格的状态流转机制：INIT → REQUIREMENTS → DESIGN → GENERATION → VALIDATION → COMPLETE。每个状态都有明确的准入条件、执行动作、准出条件和验证门禁。
从”道德约束”到”物理阻断”
纯 Markdown 文档依赖 AI 的”服从度”，而工程化脚本是不讲武德的。如果规定”必须运行 scripts/validate_requirements.py 且返回退出码 0 才能进入下一步”，这就构成了状态机的硬性卡点。AI 即使想”飘”，控制台红色的 Error 也会像巴掌一样把它打醒。
TDD 验证门禁优先 每个状态都配备专门的验证脚本，只做一件事：检查当前状态的输出是否符合标准，返回 0（通过）或非 0（失败）。
内置降级反思逻辑
三级降级机制：首次失败记录日志并重试，二次失败调整方案重试，三次失败熔断升级——停止所有操作，生成 BLOCKED.md 详细报告，请求人工干预，绝对禁止继续尝试。
过程 / 推演
技术实现的关键点
状态机的严格定义 每个状态都用 JSON 结构化定义，包含 name、purpose、entry_conditions、actions、exit_conditions、gateway_script 和 next_states。这确保了状态流转的可审计性和确定性。
全局约束的强制执行
在 SKILL.md 中明确列出 FORBIDDEN 和 REQUIRED 行为。禁止生成没有验证门禁的 SOP，禁止使用模糊语言；必须使用命令式语言，必须为每个状态包含错误处理。
输出结构的标准化 生成的 SOP 包含完整的工程化结构：README、主 SOP 文档、进度追踪模板、错误日志模板、验证脚本目录和元数据文件。
实践中的权衡
Markdown vs 工程化工具包
最好的做法是按需分配。对于架构设计、API 接口定义等需要 AI 发挥推理能力的高自由度任务，使用 Markdown；对于操作文件系统、自动化打包等”一步走错全盘崩溃”的低自由度任务，使用工程化工具包。因此，sop-creator 的最佳实践是：用 Markdown 框定”要什么结果”，用脚本充当”怎么算做对”的物理卡点。
中文 vs 英文 我选择了英文作为主要语言。英文的 Token 编码效率是中文的 2-3 倍，能显著减少上下文膨胀；英文指令能更直接激活模型的”严谨工程”权重；终端报错都是英文，用英文撰写 SOP 可以实现零损耗的报错匹配。但在日常交互和思考时，我依然使用中文，这样能保证思维不被语言表达所限制。
使用效果
生成的 SOP 具有确定性执行、自动熔断、可审计和可复用四大特点。最重要的是，它把我在 Obsidian 里沉淀的零散开发经验，转化为了高确定性的工程约束。验证脚本可以直接集成到 CI/CD 流程，实现了从本地工作流到云端自动化的无缝衔接。
结语 / 反思
在构建这个元工具时，最大的风险是”过度设计”。我时刻提醒自己：优秀的 SOP 应该像函数签名一样简洁。不要试图用一个巨无霸 SOP 解决所有问题，应该为最熟悉的工作流写一个精简的、包含严格测试卡点的 Skill，在实际使用中不断修剪它。
sop-creator.skill 是给 Claude 打造的”物理外挂”，但作为主导者的我，也需要在 Obsidian 里建立对应的”控制台”。我创建了永久笔记记录 VibeCoding 的核心法则，以及 SOP 起手式模板用于构思新 SOP。这样，我的”人类大脑”和”AI 副手大脑”就完成了底层逻辑的绝对对齐。
从理念到工具，我有了进一步的领悟：工程化的本质是把不确定性转化为确定性。VibeCoding 提供了思想框架，sop-creator 把它固化为可执行的物理约束。当你能用这套工具稳定、可预期地重复输出高质量的工程结构时，它就成了你个人开发能力的极效放大器。
而这一切的起点，都源于那个最简单的认知：克制 AI 的盲目，是所有优秀规范的底层逻辑。
想看这套理念如何落地？请看下篇《从理念到工具：打造 SOP-Creator.skill 的实践》