mcpField
O
openspec-onboard

openspec-onboard

github.com/full-stack-skillsAgent 工作流188 次安装4 周前更新
代码仓库

关于 openspec-onboard

openspec-onboard 面向 OpenSpec 新手提供交互式教程，使用项目的实际代码库完成从发现改进机会到归档变更的完整流程。

主要功能

  1. 01引导式 OpenSpec 工作流教程
  2. 02分析实际代码库
  3. 03创建并实施真实变更
  4. 04验证并归档变更

适用场景

  1. 01首次动手学习 OpenSpec
  2. 02在正式项目工作前练习流程

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/full-stack-skills/openspec-skills --skill openspec-onboard

安装后在 Claude Code 中输入/openspec-onboard确认已加载。

附带文件agents/openai.yaml

详细介绍

OpenSpec 入门技能

使用 /opsx:onboard，通过引导式交互教程完整体验 OpenSpec 工作流。教程使用用户的实际代码库：寻找真正的改进机会、创建真实变更、实现变更并将其归档。

适用场景

  • 首次使用 OpenSpec，并希望通过实践了解其工作流程的用户。
  • 用户说“入门”“教程”或“向我展示 OpenSpec 的工作方式”。
  • 在将工作流用于实际工作之前先熟悉它。

前提条件

  • 项目中已初始化 OpenSpec（请参阅 openspec-initial）。

工作流程

  1. 开始入门教程

    • 运行 /opsx:onboard。

  2. 教程阶段

    1. 欢迎并分析代码库。
    2. 寻找改进机会（小而安全的变更）。
    3. 创建变更（/opsx:new）。
    4. 编写提案。
    5. 创建规范。
    6. 编写设计。
    7. 创建任务。
    8. 实施任务（/opsx:apply）。
    9. 验证实现。
    10. 归档变更。
    11. 总结并介绍后续步骤。

  3. 交互式体验

    • Agent 会在每个步骤进行时解释该步骤。
    • 用户选择要处理的改进事项。
    • 创建的变更是真实的，可保留或丢弃。

输出

  • 使用用户的实际代码库完成一次完整的变更周期（从提案到归档）。
  • 用户亲身体验所有 OPSX 命令。

后续步骤

  • 使用 openspec-new 或 openspec-explore 开始实际工作。

故障排除

  • “无法识别命令”：确保已初始化 OpenSpec（openspec init）。请参阅 openspec-initial。
  • 耗时过长：教程涵盖完整工作流程，预计需要 15–30 分钟。

参考资料

评论

支持 Markdown