SuperAPI AI 工具集

openspec-onboard

办公与效率

查看项目

更新于 10-16 09:52

技能介绍

用途:这是 OpenSpec 的引导式入门(onboarding)技能,目标是在用户真实代码库中完成一次完整的变更循环,边做边讲解每个步骤,约需 15-20 分钟。

主要流程与能力:

  1. 预检:先检查项目是否已初始化 OpenSpec,命令为 openspec status --json 2>&1 || echo "NOT_INITIALIZED";未初始化时提示先运行 openspec init 再回到 /opsx:onboard,并停止。
  2. 选择任务:扫描代码库中的小改进点,如 TODO/FIXME/HACK/XXX 注释、缺失错误处理、无测试函数、TypeScript 的 any、调试残留(console.log、debugger)、缺失输入校验等,并查看近期 git 记录(git log --oneline -10)。随后给出 3-4 个具体建议供选择;范围过大时温和提示切小或坚持继续。
  3. 探索演示:用 1-2 分钟查看相关代码,说明 explore 模式(/opsx:explore)用于实现前思考问题。
  4. 创建变更:使用 openspec new change "<derived-name>",生成 openspec/changes/<name>/ 目录,含 proposal.md、design.md、specs/、tasks.md。
  5. 依次构建产物:提案(说明 Why/What Changes/Capabilities/Impact,保存前用 openspec instructions proposal --change "<name>" --json 获取指令后写入 proposal.md);规格(requirement 与 WHEN/THEN/AND 场景格式,写入 specs/<capability>/spec.md);设计(Context、Goals/Non-Goals、Decisions,写入 design.md);任务(带复选框的实现清单,写入 tasks.md)。
  6. 实施:逐条实现任务并勾选 tasks.md,结合规格与设计说明取舍。
  7. 归档:openspec archive "<name>",移动到 openspec/changes/archive/YYYY-MM-DD-<name>/。
  8. 总结与命令参考,并提供优雅退出:用户想暂停时可稍后用 /opsx:continue <name> 或 /opsx:apply <name> 继续;只想看命令时给出速查表。

命令参考:/opsx:explore、/opsx:new、/opsx:ff、/opsx:continue、/opsx:apply、/opsx:verify、/opsx:archive。

限制:需项目已初始化 OpenSpec;本技能是教学式引导而非自动化工具。其余如具体支持的平台、收费与价格信息暂未提供。