SuperAPI AI 工具集

openspec-onboard

编程与开发

查看项目

更新于 10-16 03:17

技能介绍

用途:这是 OpenSpec 的引导式入门(onboard)技能,目标是在用户真实代码库中完成一次完整的 OpenSpec 变更循环,边做真实工作边讲解每一步,属于教学体验。

主要能力与流程:先做预检,运行 openspec status --json 2>&1 || echo "NOT_INITIALIZED" 检查是否已初始化;未初始化则提示先运行 openspec init,然后停止。随后依次进行:欢迎说明;任务选择(扫描代码库中的 TODO/FIXME/HACK/XXX、缺失错误处理、无测试函数、TypeScript 的 any、调试残留、缺失校验,并查看 git log --oneline -10,给出 3-4 个具体建议,任务过大时给出缩小范围等软性护栏);探索演示(阅读相关文件、必要时画 ASCII 图);创建变更(openspec new change "<derived-name>",生成 openspec/changes/<name>/ 下的 proposal.md、design.md、specs/、tasks.md);编写提案(用 openspec instructions proposal --change "<name>" --json 后写入 proposal.md);编写规格(mkdir -p openspec/changes/<name>/specs/<capability-name>,采用 Requirement 与 WHEN/THEN/AND 场景格式);编写设计(Context、Goals/Non-Goals、Decisions);拆解任务(复选框清单);实现(逐项完成并在 tasks.md 中勾选);归档(openspec archive "<name>",移动到 openspec/archive/YYYY-MM-DD--<name>/);最后回顾并给出命令参考。

使用方式:按阶段推进,在探索后、提案草稿后、任务后、归档后等关键节点遵循 EXPLAIN → DO → SHOW → PAUSE 模式暂停等待确认。命令参考包括 /opsx:explore、/opsx:new、/opsx:ff、/opsx:continue、/opsx:apply、/opsx:verify、/opsx:archive。

适用场景:希望学习 OpenSpec 工作流、在真实代码库中完成首个变更循环的用户。

限制:需先初始化 OpenSpec,否则流程停止;实现阶段讲解保持轻量;不跳过阶段;用户中途退出时变更保存在 openspec/changes/<name>/,可用 /opsx:continue 或 /opsx:apply 恢复;任务范围过大时仅作软性引导,尊重用户选择。其他收费、平台等信息暂未提供。