Home / minleev5 / devkeel · .harness/skills/openspec-onboard/SKILL.md · GitHub

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

Latest version
mdr add minleev5/devkeel/openspec-onboard@v2.4
Exact content
mdr add minleev5/devkeel/openspec-onboard@sha256:f1b8138cd1c9f250

Pin 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.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_rzldm5tsyt22lkxz.svg)](https://markdownregistry.com/a/art_rzldm5tsyt22lkxz)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
v2.4 latest2026-09-24 8bc6bbc 5,727 BA view · diff
v2.32026-09-23 6c34cd9 5,727 BA view · diff
v2.22026-09-22 123429c 5,709 BA view

Audit of the latest version

A  17 of 17 checks passed. Deterministic, no model, same answer every run.
  • 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

GitHub

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

brainstorming skill
minleev5/devkeel · .harness/skills/brainstorming/SKILL.md · 探索、比较、挑战或补全开发方案;按 Lite/Full 深度进行单题访谈,并在用户同意持久化后维护 OpenSpec Living brainstorm。
v9.1.1 · audit A · 3 stars
changelog skill
minleev5/devkeel · .harness/skills/changelog/SKILL.md · Use when 编辑 changelog、发布 CLI 或模板版本、或判断某项用户可见变更是否需要进入版本记录。
v3.0.0 · audit A · 3 stars
commit skill
minleev5/devkeel · .harness/skills/commit/SKILL.md · 用户明确选择 commit、push 或 MR/PR 后使用的原子交付流程。任务完成或归档本身不触发;在授权范围内完成交付目标及其必要动作。
v1.2.4 · audit A · 3 stars
doc-maintenance skill
minleev5/devkeel · .harness/skills/doc-maintenance/SKILL.md · CLI 文档维护与一致性检查流程
v1.2.0 · audit A · 3 stars
domain-init skill
minleev5/devkeel · .harness/skills/domain-init/SKILL.md · 对项目进行全盘扫描,识别领域类型和技术栈,通过多 subAgent 并行扫描多维度, 生成项目知识 docs 与专属 rules、skills 和 agents。使用「自动 baseline + 交互式增强」…
v2.0.2 · audit A · 3 stars
health-check skill
minleev5/devkeel · .harness/skills/health-check/SKILL.md · 一键检查项目代码健康度指标
v1.0.0 · audit A · 3 stars
instruction-maintenance skill
minleev5/devkeel · .harness/skills/instruction-maintenance/SKILL.md · 精简并校验 AGENTS.md、OpenSpec schema/instruction、OPSX commands、SKILL.md、prompt 与 artifact 模板。用于审查当前 diff…
v1.0.0 · audit A · 3 stars
jira-defect-orchestrator skill
minleev5/devkeel · .harness/skills/jira-defect-orchestrator/SKILL.md · 独立编排 Jira 缺陷的取证、修复、验证、回填与 MR 交付,按决策风险确认。适用于用户提供 Jira URL 或 issue key,要求结合运行日志、配置、只读业务数据和代码证据处理生产或测试环境缺陷;普通无 Jira…
v1.3.2 · audit A · 3 stars
new-subcommand skill
minleev5/devkeel · .harness/skills/new-subcommand/SKILL.md · 为 DevKeel CLI 新增子命令的标准开发流程
v1.0.0 · audit A · 3 stars
openspec-apply-change skill
minleev5/devkeel · .harness/skills/openspec-apply-change/SKILL.md · 按 OpenSpec 动态 apply instruction 实施 change tasks,并处理 DevKeel 收尾门禁。
v3.2 · audit A · 3 stars
openspec-archive-change skill
minleev5/devkeel · .harness/skills/openspec-archive-change/SKILL.md · 检查完成状态、评估 spec sync,并按 schema 收尾门禁归档 OpenSpec change。
v3.3 · audit A · 3 stars
openspec-bulk-archive-change skill
minleev5/devkeel · .harness/skills/openspec-bulk-archive-change/SKILL.md · 批量检查 spec 冲突,并按 schema 门禁归档用户明确选择的多个 OpenSpec changes。
v2.2 · audit A · 3 stars

Every file in minleev5/devkeel

Other files named openspec-onboard

openspec-onboard skill
rustyrazorblade/skills · .claude/skills/openspec-onboard/SKILL.md · Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.
v1.0 · audit A · 43 stars
openspec-onboard skill
yazelin/ching-tech-os · .github/skills/openspec-onboard/SKILL.md · Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.
v1.0 · audit A · 32 stars
openspec-onboard skill
yazelin/ching-tech-os · .claude/skills/openspec-onboard/SKILL.md · Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.
v1.0 · audit A · 32 stars
openspec-onboard skill
justinjdev/fellowship · .claude/skills/openspec-onboard/SKILL.md · Guided onboarding for OpenSpec - walk through a complete workflow cycle with narration and real codebase work.
v1.0 · audit A · 5 stars

Browse by kind, by grade A, or by owner.