首页 > AI教程 >分钟上手一行命令搭建AI工作流

分钟上手一行命令搭建AI工作流

来源：互联网 2026-06-26 06:30:18

AI资讯合集

使用npxopsx-dev-pipelineinit命令可快速将AI工作流安装至项目，支持Claude、Cursor等主流AI工具。通过--dry-run安全预览生成文件，零风险且操作简单。安装后生成完整知识库骨架与详细技能目录，后续可自动同步升级，实现工作流持续演进，显著提升开发效率与协作能力。

系列: SDD 系列 ·《搭建你自己的 AI 研发工作流》

期号: 第 02 期

长期稳定更新的攒劲资源： >>>点此立即查看<<<

本期主角: init / list-tools / doctor

预计阅读: 7 分钟

先有体感，再讲原理。这一期我们把工作流装进真实项目，并学会零风险地预览它。

本期导读

安装前要准备什么（Node、OpenSpec）
交互式 vs 非交互式两条安装路径怎么选
用 --dry-run 安全预览，不动你项目一根毫毛
四种 AI 工具的落地目录差异，以及装完项目里多了什么

30 秒能用上：在任意项目根目录跑 npx opsx-dev-pipeline init --tool claude --yes --dry-run，它会只预览、不写入，告诉你将要生成哪些文件。看一眼，心里就有数了。

一、先别急着原理，先跑起来

上一期我们立了个主张：工作流应该是"可安装的资产"。这一期我们就把它装进项目，亲手验证这句话。

整个过程不超过 5 分钟，目标只有一个——让你有体感。原理留到第 3、4 期慢慢拆。

前置条件

两样东西：

Node.js ≥ 20。
OpenSpec 已安装。这是工作流流水线依赖的规格底座，先装好它：OpenSpec。

没装 OpenSpec 也能生成模板文件，但 opsx-dev-pipeline 这条全流程流水线在执行时会提示你先安装。建议一步到位。

二、最快的一条路：交互式安装

推荐直接使用 npx 初始化，它会带你走一遍交互选择：

npx opsx-dev-pipeline@latest init

它会依次问你三个问题：

Project name —— 项目名，默认取当前目录名，回车即可。
Select your AI tool —— 选你用的 AI 工具，默认 Claude Code。
Enable opsx-prototype —— 是否开启可选的"原型/截图 → 需求"技能，默认关。

有个贴心细节：如果你的项目里已经有 CLAUDE.md、.claude/、.cursor/ 这类标记文件，它会自动识别你在用哪个工具，并把它作为默认选项。你大概率一路回车就行。

分钟上手一行命令搭建AI工作流

三、更适合脚本化的一条路：非交互安装

如果你想跳过所有提问（比如写进团队脚本、CI，或者你心里已经有答案），用 init 加 --yes：

npx opsx-dev-pipeline init --tool claude --yes

--yes 的含义是"别问了，用默认值和我给的 flag"。几个常用组合：

# 只预览，不写任何文件（强烈建议第一次这么跑）
npx opsx-dev-pipeline init --tool claude --yes --dry-run

# 开启可选的原型分析能力
npx opsx-dev-pipeline init --tool claude --yes --feature prototype

# 目标目录已有同名文件时，允许覆盖被管理的文件
npx opsx-dev-pipeline init --tool claude --yes --force

小贴士：init 对常见文件（.git、README.md、package.json、锁文件等）是宽容的——目录里有它们不会被当成"非空冲突"，可以放心在已有项目里跑。

四、`--dry-run`：先看清它要动什么

第一次在一个真实项目里跑，最稳妥的做法是先 --dry-run。它不会写入任何文件，只会打印一份"将要创建的清单"：

Dry run: the following files would be created:
- README.md
- .gitignore
- .knowledge/INDEX.md
- .knowledge/...
- CLAUDE.md
- .claude/skills/opsx-dev-pipeline/SKILL.md
- .claude/skills/opsx-learn/SKILL.md
- .claude/commands/opsx-dev-pipeline.md
- ...

看清楚、确认没问题，再去掉 --dry-run 正式执行。这是一个对你项目零风险的"安全演练"。

正式执行成功后，你会看到一句绿色的确认，外加几条安装后提示：

Initialized opsx-dev-pipeline for Claude Code.
- Try /opsx-dev-pipeline in Claude Code to start an OpenSpec change.
- Seed project knowledge with /opsx-learn and inspect .knowledge/INDEX.md.

五、四种工具，落地位置各不相同

同样一套技能内容，会根据你选的工具落到不同目录——这正是它"跨工具复用"的体现（背后的设计第 4 期细讲）。

工具 ID	工具	生成目录 / 文件
`claude`	Claude Code	`CLAUDE.md`、`.claude/skills/`、`.claude/commands/`
`cursor`	Cursor	`.cursor/rules/`、`.cursor/commands/`、`opsx-dev-pipeline.mdc`
`codex`	Codex	`.codex/prompts/`、`.codex/commands/`

想知道当前内置支持哪些工具，随时查：

npx opsx-dev-pipeline list-tools

六、装完之后，项目里多了什么

以 Claude Code 为例，init 后你的项目大致会多出这样一棵树：

你的项目/
├── CLAUDE.md                    # 规则覆盖层：注入"知识优先"等规范
├── .knowledge/                  # 知识库骨架（business/tech/config/ops/risks/project）
│   └── INDEX.md
├── .claude/
│   ├── skills/                  # 12 个技能，每个是一套可执行 SOP
│   │   ├── opsx-dev-pipeline/
│   │   ├── opsx-learn/
│   │   └── ...
│   └── commands/                # 每个技能对应的轻量命令入口
│       ├── opsx-dev-pipeline.md
│       └── ...
└── ...

它还会写一份 manifest（清单文件），记录"哪些文件是它管理的"。这份清单是后续 sync（重渲染）和 upgrade（升级模板）的依据——也就是说，这套工作流装进来之后，还能随项目一起持续演进，而不是装完就僵死。

七、装完先试一句

别让它躺着。打开你的 AI 工具，直接试一条命令找找感觉，比如：

/opsx-learn 梳理用户登录模块的业务规则与接口入口

或者用 doctor 给刚生成的知识库做个体检：

npx opsx-dev-pipeline doctor --json

分钟上手一行命令搭建AI工作流

到这里，你已经把一整套研发流水线装进了项目。它现在还只是"骨架"，但接下来的每一期，我们都会让其中一块真正运转起来。

一句话总结

init 一行命令把工作流装进项目，--dry-run 让你先看后写、零风险，sync/upgrade 让它随项目持续演进——安装从来不是终点，而是资产开始生长的起点。

动手挑战

在一个 demo 仓库（或新建空目录）里，跑一次：
npx opsx-dev-pipeline init --tool claude --yes --dry-run
把打印出来的"将要创建的文件清单"截图保存。
然后回看第 1 期你列的"重复度最高的 3 件事"——对照这份清单，看看其中有几件，已经能在生成的技能/命令里找到对应入口？

下期预告：第 03 期《Skill 是什么：渐进式披露的艺术》。我们会打开 .claude/skills/ 里那些目录，拆解一个 skill 到底由什么构成，以及它为什么不把所有内容塞进一个文件——这是整套工作流最关键的设计思想。