OpenSpec 入门：把 AI 编程需求变成可审阅的变更材料
OpenSpec 快速上手：先约定 CSV 导出，再授权实施
在独立样例项目初始化指引，用可核对的输入输出检查第一份规格。
OpenSpec 快速上手：先约定 CSV 导出，再授权实施知识学习CN编辑简报更新 2026-09-23
你将学会
- 准备可恢复的试验
- 初始化后使用正确入口
- 给场景明确的验收条件
开始前需要
- 基本 Git 与 Node 知识
- 可独立试验的样例仓库
用合成模式解释阻塞原因，把规划状态与实现证据放在不同列中。
先看结论
- 初始化会写入项目指引。
- latest 不是固定版本。
- 已知输入使场景可验证。
准备可恢复的试验
使用新的样例仓库或独立工作树，保留已有未提交改动。所检查的 README 要求 Node.js 至少为 20.19.0；记录实际安装版本，因为 latest 会继续变化。
下面的 npm 命令来自上游文档，会修改全局安装环境，执行前应确认这种影响。本篇提供操作步骤，不声称已经测试软件包安装或助手集成。
初始化后使用正确入口
在试验项目运行 openspec init，然后检查文件差异。它会打印你选择的工具对应的调用方式；提案指令应输入助手界面，而不是当作终端程序执行。
提出 CSV 导出需求时说明带逗号字段的转义和空结果行为。先审阅提案、规格和设计，再授权实现；默认配置有 explore 和 propose，扩展指令需要切换配置并更新。
给场景明确的验收条件
写出已知输入行和预期转义结果。默认模式使用 Requirement 标题、四个井号的 Scenario 标题，以及 WHEN 和 THEN；任务条目也应该明确如何验证。
如果初始化修改了意外的项目，或提案虚构了你没有要求的行为，应暂停。先审阅差异，再恢复自己产生的试验改动，不要清除其他人的工作。
如何选择
| 比较维度 | 方案 A | 方案 B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
实施步骤
- 1
确认 Node 并保存原工作区。
- 2
初始化后核对调用方式。
- 3
审阅场景后再允许实施。
可复制示例
bash
node --version
npm install -g @fission-ai/openspec@latest
cd your-trial-project
openspec --version
openspec init常见问题
提案命令在哪里输入？
在支持的助手界面输入，并使用初始化打印的对应拼写。
可以直接用有未提交改动的生产目录吗？
建议使用独立样例或工作树，保留原有改动。
资料来源
- OpenSpec / README.md来源核查 2026-09-23
- OpenSpec / schemas/spec-driven/schema.yaml来源核查 2026-09-23