ospec
一个为AI编程助手设计的规范驱动工作流框架。
安装使用
复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:
帮我安装这个 AI Skill:ospec。 它的用途是:一个为AI编程助手设计的规范驱动工作流框架。 完整的 Skill 内容见:https://321skill.com/skills/ospec/raw/index.md 请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“使用ospec为这个React项目添加一个用户登录组件。”,它会引导你初始化OSpec,创建并跟踪一个名为“添加登录组件”的变更(Change),生成计划、实现代码,并最终将整个工作流归档到项目仓库中,便于后续审查或接续开发。
介绍
OSpec 旨在解决AI编码助手(如Claude Code、Cursor等)在开发过程中,需求与上下文仅存在于聊天记录中,难以审查、追踪和归档的问题。它通过引入一个轻量级的工作流层,将变更的完整上下文(包括提案、设计、计划、任务、评审和验证证据)以文件形式保存在代码仓库中,而非易失的聊天历史里。
使用上,OSpec 主要通过两个核心命令工作:ospec change 用于处理日常快速变更,如功能修改、文档更新或Bug修复,遵循初始化 -> 变更 -> 验证/定稿的轻量路径;ospec goal 则用于处理更大或更具风险的工作,AI会协助制定可审查的计划、实现、测试、请求独立评审并更新项目文档,直到目标被证明完成。
它非常适合依赖AI助手进行代码开发的工程师和团队,尤其是那些希望将AI协作过程规范化、可追溯化的前端、后端及全栈开发者。
建议在项目初期或开始一项新功能时引入OSpec,它能帮助清晰定义工作范围。注意,它并非替代版本控制或CI/CD,而是作为AI协作过程的补充规范层,更适合在有一定规范意识的团队中使用。
核心特点
与单纯提供代码片段的AI助手不同,OSpec 将“规范驱动开发”和“循环工程”理念引入AI协作流程,强制生成可存档、可复用的工作产物(如计划、评审记录),确保任何AI助手都能基于仓库中的规范文件无缝接续工作,而非依赖难以管理的聊天历史。
注意事项
不适合追求极致快速、无需留痕的临时性代码调试或一次性脚本编写场景。
常见问题
OSpec 和 Git 有什么区别?
Git管理代码版本,OSpec管理AI协作的工作流和决策上下文,两者互补。OSpec的产出(规范文件)也由Git管理。
必须使用特定的AI编码助手吗?
不需要。OSpec设计为与Claude Code、Cursor、通用CLI等多种AI助手或工作流协同,核心是将规范持久化到仓库。
给 AI 助手的安装指引
如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:
请访问 https://321skill.com/skills/ospec/raw/index.md 读取 ospec 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址:/skills/ospec/raw/index.md(查看排版版本)