openspec-onboard skillA
openspec-onboard is agent-read markdown (skill) from minleev5/devkeel: 用真实小型代码任务,分阶段讲解并完成第一轮 OpenSpec 工作流。.
Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.
What the file says
带用户边做边学,完成第一轮真实 OpenSpec cycle。本 skill 保留 OpenSpec 1.12.0 官方 Onboard 的 11 阶段教学、真实任务、轻量讲解和优雅退出;artifact 名称与顺序改为动态 schema 驱动。 ## Preflight ```bash npx devkeel@latest openspec --version ``` CLI 不可用时说明问题并停止。可用时说明教程约需 15~20 分钟;用户可以随时暂停或只查看 命令参考。 ## Phase 1:欢迎 说明本轮会:选择真实小任务、简短 Explore、创建 change、逐个理解 planning artifacts、实施 tasks、验证并归档。强调不同 schema 的 artifact 图不同,以 CLI status 为准。 ## Phase 2:选择真实任务 只读扫描代码库,寻找 3~4 个适合入门的候选,例如 TODO/FIXME、缺少错误处理或验证、邻近 测试缺口、类型问题和调试残留;查看最近 git 活动帮助判断上下文。每个候选列出位置、 预计范围和适合作为教程的原因,让用户明确选择。 没有明显候选时询问用户想完成的小任务。任务过大时建议切出最小有用部分,但这是软守卫; 用户可以坚持原范围。 ## Phase 3:Brainstorming 演示 用 1~2 分钟读取相关入口、邻近测试和直接依赖,说明 topic-only、单题访谈和阶段与关键缺口提示。解释 需求/技术探针只发现下一项 gap,不生成第二套设计。 按官方教学节奏暂停,等待用户确认理解后再创建 change。 ## Phase 4:创建 change 与 Living brainstorm 说明 OpenSpec 只在跨会话、交接、并行或审计有价值时持久化。加载并遵循 `openspec-new-change`;默认 Lite,只有显式选择或风险确认才用 Full。New 在同一轮把 已确认上下文写入 Living brainstorm,并继续一个问题,不只创建空脚手架。 创建后展示 status 返回的 `schemaName`、`planningHome`、`changeRoot`、`artifactPaths`、 `actionContext` 和 artifact 顺序。不得展示假想固定目录树。 ## Phase 5~8:逐个学习 planning artifacts 先通过 Brainstorming 闭合关键缺口,满足快照确认条件后展示全部 D/A,并由用户明确确认。 然后循环投影每个 Apply 前置 artifact,每一步保持官方 **EXPLAIN → DO → SHOW → PAUSE**: …
Read the whole file at its exact version.
How to install
mdr add minleev5/devkeel/openspec-onboard@v2.4mdr add minleev5/devkeel/openspec-onboard@sha256:f1b8138cd1c9f250Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.
[](https://markdownregistry.com/a/art_rzldm5tsyt22lkxz)
1 badge views in 30 days
Versions
| version | committed | commit | size | audit | |
|---|---|---|---|---|---|
| v2.4 latest | 2026-09-24 | 8bc6bbc | 5,727 B | A | view · diff |
| v2.3 | 2026-09-23 | 6c34cd9 | 5,727 B | A | view · diff |
| v2.2 | 2026-09-22 | 123429c | 5,709 B | A | view |
Audit of the latest version
- pass: Frontmatter block present
- pass: Frontmatter declares a name
- pass: Frontmatter declares a description
- pass: Size between 200 bytes and 200 KB (5727 bytes)
- pass: No zero-width or bidi control characters
- pass: No instruction hidden inside an HTML comment
- pass: No link to an exfiltration or paste host
- pass: No credential-shaped string
- pass: No instruction to send local credentials anywhere
- pass: No text hidden with inline styles
- pass: No prompt-injection phrasing
- pass: No curl or wget piped into a shell
- pass: No recursive delete of root, home or parent
- pass: No instruction to read or print local credentials
- pass: No base64 blob over 200 characters
- pass: No link to a raw IP address
- pass: No script tag
Source
minleev5/devkeel · 3 stars · license MIT · pushed 2026-09-24 · branch master
API
GET https://markdownregistry.com/api/v1/artifacts/art_rzldm5tsyt22lkxz GET https://markdownregistry.com/api/v1/resolve?ref=minleev5/devkeel/openspec-onboard GET https://markdownregistry.com/api/v1/blob/f1b8138cd1c9f250ba60c7959c16caa808cdc486cc27b2bbeff60d03887f0e84
Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.
More from minleev5/devkeel
Every file in minleev5/devkeel