技能介绍

解决什么问题

当 Agent 接收一个编码请求时，很容易从一句临时指令开始，然后失去上下文：需求只存在于聊天里，变更被一次性推进，验证缺少明确证据，之后也难以复盘或归档。这个技能引入 OSpec，把编码请求转化为仓库持久化的 spec 工作流，覆盖初始化、变更推进、验证证据和归档。

技能如何工作

核心路径可以概括为四个步骤：

初始化：在目标仓库创建 spec，通过 --summary 写明业务目标，并通过 --tech-stack 传入逗号分隔的技术栈，例如 node,react,postgres。
推进变更：Agent 运行时消费 spec 工作流，按阶段推进当前变更，而不是把请求当成一次不透明的 prompt。
保留验证证据：每次推进都需要验证证据，使变更具备可测试或可检查的依据，而不是只靠自然语言声明。
归档：当变更收尾时，spec 和相关证据保留在仓库中，形成可追溯历史，而不是随对话结束消失。

适用边界与注意点

它不是万能代码生成器，也不会自动替你确定技术栈或架构决策。运行环境需要 Node.js 18+、npm、@clawplays/ospec-cli，以及兼容的 Agent 运行时，例如 Claude Code、Codex、Gemini、OpenCode 或基于 shell 的 CLI Agent。--tech-stack 应如实、完整；如果 --summary 过于模糊，初始化出的 spec 约束力会不足。它依赖上游文档和项目自身规范，若仓库已有 spec、任务跟踪、lint 或 CI 体系，应把 OSpec 工作流与现有治理方式合并，否则它可能只会变成额外的文件和流程。