Qwen Code 与 OpenSpec 实战指南：AI 驱动开发安装与落地

其他说明

• 存储位置：~/.qwen/skills/
• 运行命令：/skills <skill-name>

2. 安装 OpenSpec

2.1 基本信息

• GitHub：https://github.com/Fission-AI/OpenSpec

主流开源 SDD 工具对比

OpenSpec 核心流程

┌────────────────────┐ │ Draft Change │ │ Proposal │ └────────┬───────────┘ │ share intent with your AI ▼ ┌────────────────────┐ │ Review & Align │ │ (edit specs/tasks) │◀──── feedback loop ──────┐ └────────┬───────────┘ │ │ approved plan │ ▼ │ ┌────────────────────┐ │ │ Implement Tasks │──────────────────────────┘ │ (AI writes code) │ └────────┬───────────┘ │ ship the change ▼ ┌────────────────────┐ │ Archive & Update │ │ Specs (source) │ └────────────────────┘ 

流程步骤：

1. 起草变更提案（捕获规范更新意图）。
2. 与 AI 助手审核提案至共识。
3. 实施引用已批准规范的 task（AI 写代码）。
4. 归档变更，将批准的更新合并回源规范。

2.2 安装步骤

前置条件

Node.js ≥ 20.19.0（通过 node --version 检查版本）。

第一步：全局安装 CLI

# 安装
npm install -g @fission-ai/openspec@latest
# 确认安装
openspec --version

第二步：项目中初始化 OpenSpec

# 进入项目目录
cd my-project
# 运行初始化
openspec init

初始化过程：

• 提示选择原生支持的 AI 工具（Claude Code、CodeBuddy 等），其他 agent 依赖共享存根 AGENTS.md。
• 自动配置所选工具的斜杠命令，在项目根写入受管理的交接 AGENTS.md。

创建 openspec/ 目录，结构如下：

openspec - AGENTS.md - project.md 

project.md 参考：一个 AI 编码的项目规范约束（project 规范）。

第三步：检查状态

openspec list # 验证设置状态，查看当前活跃变更提案

初始化后，主流 AI 工具可直接使用 /openspec 相关命令。

2.3 配置 Qwen Code

执行 openspec init 选择 AI 模型时选 qwen-code，会在当前目录创建 .qwen 目录，含三个配置文件：

.qwen - commands - openspec-apply.toml - openspec-archive.toml - openspec-proposal.toml 

3. AI 编码实践

3.1 配置 OpenSpec 项目约束文件

openspec init 后生成：

• AGENTS.md：定义 AI 模型 agent 的引导。
• project.md：定义项目规范约束（可由 AI 生成）。

3.2 创建变更（五步骤）

1. 起草提案

启动 qwen-code（qwen 或 qwen --experimental-skills），提交变更请求：

/openspec-proposal 构建一个业务场景 agent 注册中心生成注册表，提供新增、编辑和查询功能，一个业务场景只有一个生效的智能 

生成目录结构：

openspec - changes - 对应变更名称（AI 创建的名称） - design.md （提案设计） - proposal.md （变更提案） - tasks.md （完成任务所需任务） 

2. 核实与审核

检查变更是否正确创建并审查提案：

$ openspec list # 确认变更文件夹存在
$ openspec validate add-profile-filters # 验证规范格式
$ openspec show add-profile-filters # 审查提案、任务和规范差异

3. 检查与完善

若 AI 理解偏差或提案不符需求，可：

• 与 AI 多轮交流修正提案设计。
• 手动修改 design.md、proposal.md 等文档。

4. 实施任务

文档完善后，执行实施：

/openspec-apply 指定开始实施的任务 

5. 归档变更

验证无误后归档：

/openspec-archive 指定归档的变更