spec-author

Edit Open Document Spec modules under specs/{ods,okf,skills}. Use when changing normative or author-facing dialect docs, renames, or reading maps.

安装方式

默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。

用 Codex 或 Claude 帮你安装复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。

直接命令不会经过审查 Prompt；运行前请先检查来源。

npx skills add https://github.com/open-doc-spec/ods --skill spec-author

命令会保持在同一行。复制前请横向滚动并检查完整内容。

想先保存到本地？可下载 SkillsMP 当前能够提供的文件。

决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。

SKILL.md

来源说明 · 只读预览

name	spec-author
description	Edit Open Document Spec modules under specs/{ods,okf,skills}. Use when changing normative or author-facing dialect docs, renames, or reading maps.

specs/
  index.ods.md
  ods/   intro keys core profiles graph context indexes assets validation scope
  okf/   intro keys
  skills/ intro keys

Read specs/ods/intro.md and keys.md before inventing frontmatter.
Keep one idea per file. Do not re-dump the full key table into core.md.
ODS voice:
- intro — plain language for end users
- keys — dictionary + examples
- core / others — precise; RFC 2119 where normative
Link with relative paths inside the dialect folder.
After edits, grep for dead paths (SPEC.md, non-goals, resources-and-code, flat /spec/graph).
Sync skill copies under skills/ods/references/ when ODS intro/keys/core/scope change.
Update app-web nav + sitemap.xml.ts + redirects in astro.config.mjs if routes change.

File name is one word and matches content
Frontmatter order / description set for site sorting
Indexes (index.ods.md) list new children
If keys changed: update src/ods-core/src/spec/schema.rs in the same PR (registry is engine SoT)
Sync skills/ods/references/ when ODS intro/keys/core/scope change
CHANGELOG Unreleased note