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

openspec-sync-specs skillA

openspec-sync-specs is agent-read markdown (skill) from minleev5/devkeel: 将 active change 的 delta specs 智能合并到 main specs，但不归档 change。.

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

把 delta specs 合并到 main specs，并保持 change active。这是 OpenSpec 1.12.0 官方定义的
agent-driven 语义合并，不是整文件覆盖。

## 1. 选择并解析上下文

显式名称优先；其次使用对话中无歧义的 change。无法唯一确定时运行 `list --json`，只展示有
delta specs 的候选并让用户选择；不得猜测。

```bash
npx devkeel@latest openspec status --change "<name>" --json
```

使用 `schemaName`、`planningHome`、`changeRoot` 和 `artifactPaths`，以返回的当前仓库路径定位
main specs；路径无法解析或超出 `planningHome.root` 时停止，不得猜测替代位置。

DevKeel schema 先运行共享 planning-state 检查器；仅有效 CONFIRMED 且下游 CURRENT 可同步。
LEGACY 先延迟迁移，DRAFT/INVALID/STALE 停止。同步只消费已确认 delta，不得在合并时创造或
“修正”新的业务语义。

读取 `<changeRoot>/.openspec.yaml`。OpenSpec 1.12 对没有 specs artifact 的 workflow 设置
`skip_specs`；为 true 时不得把临时 `specs/` 当成可同步 delta。存在这些文件应报告冲突并停止，
不存在则报告该 schema 无 spec sync 工作。

优先从 `artifactPaths.specs.existingOutputPaths` 获取 delta spec；字段缺失或列表为空时，递归发现
`<changeRoot>/specs/**/*.md`。fallback 必须解析真实路径、拒绝越出 `changeRoot` 的符号链接，
并与字段返回的路径去重；最终仍为空时报告并停止。

## 2. 预览智能合并

对每个 repo-local capability delta：

1. 读取完整 delta spec；
2. 读取对应 `openspec/specs/<capability>/spec.md`，不存在则记录为新增；
3. 解析并预览：
   - `ADDED`：主规格不存在时新增；同名 requirement 已存在时作为隐式 `MODIFIED`；
   - `MODIFIED`：更新描述或明确场景，保留 delta 未涉及的场景与内容；
   - `REMOVED`：删除完整 requirement block；
…

Read the whole file at its exact version.

How to install

Latest version
mdr add minleev5/devkeel/openspec-sync-specs@v2.2
Exact content
mdr add minleev5/devkeel/openspec-sync-specs@sha256:1c6f2b6809b272da

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_fi53ymanf7edqvvy.svg)](https://markdownregistry.com/a/art_fi53ymanf7edqvvy)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
v2.2 latest2026-09-24 8bc6bbc 3,285 BA view · diff
v2.12026-09-22 123429c 3,285 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 (3285 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_fi53ymanf7edqvvy
GET https://markdownregistry.com/api/v1/resolve?ref=minleev5/devkeel/openspec-sync-specs
GET https://markdownregistry.com/api/v1/blob/1c6f2b6809b272da52b8801afd69b228396f3e6f90451cebed6b58e073ff6a41

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-sync-specs

openspec-sync-specs skill
partcad/partcad · .claude/skills/openspec-sync-specs/SKILL.md · Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta…
v1.0 · audit A · 496 stars
openspec-sync-specs skill
partcad/partcad · .cursor/skills/openspec-sync-specs/SKILL.md · Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta…
v1.0 · audit A · 496 stars
openspec-sync-specs skill
monid-ai/monid · .opencode/skills/openspec-sync-specs/SKILL.md · Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta…
v1.0 · audit A · 356 stars
openspec-sync-specs skill
intent-driven-dev/intent-driven-template · .opencode/skills/openspec-sync-specs/SKILL.md · Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta…
v1.0 · audit A · 138 stars
openspec-sync-specs skill
rustyrazorblade/skills · .claude/skills/openspec-sync-specs/SKILL.md · Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta…
v1.0 · audit A · 43 stars
openspec-sync-specs skill
yazelin/ching-tech-os · .claude/skills/openspec-sync-specs/SKILL.md · Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta…
v1.0 · audit A · 32 stars
openspec-sync-specs skill
yazelin/ching-tech-os · .github/skills/openspec-sync-specs/SKILL.md · Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta…
v1.0 · audit A · 32 stars
openspec-sync-specs skill
jim60105/copilot-prompt · skills/openspec-sync-specs/SKILL.md · Sync delta specs from a change to main specs. Use when the user wants to update main specs with changes from a delta…
v1.0 · audit A · 21 stars

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