菜单
Use when adopting Rune for an existing project — scaffolds docs/ topology, generates codemap (incl. module index), creates feature catalog (incl. component/decision sections) with Pre-Rune entries, writes adoption ADR. One-time setup for brownfield projects.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when starting any creative work — creating features, components, or functionality, modifying behavior, or solving ambiguous problems — before design or implementation. Covers product discovery, competitive research, feature analysis, technical design, and capability spec writing. Applies to every project; routes to writing-plans (non-UI) or design-workflow (UI).
Use when finishing an edit to source files — runs format, typecheck, and console.log detection before moving to the next task.
Use when implementation of a bug fix or feature task is complete — dispatches the appropriate language and global reviewers and returns a binary APPROVE/BLOCK verdict.
Use when about to git commit — validates commit message format, lints staged files, and scans staged content for secrets and debug artifacts.
Use when reaching the design-workflow V2-4 hard gate — adversarially reviews design artifacts (token coverage, contract completeness, artifact consistency, accessibility docs, responsive coverage, DESIGN.md compliance) against docs/designs/<feature>/ before development handoff.
Use when a task involves UI — new pages, components, visual interactions, or design tokens — including work in docs/designs/, *.pen files, or with Pencil MCP tools. Skip for backend-only, config-only, or refactoring without visual impact. Routes to writing-plans on completion.
| name | onboard |
| description | Use when adopting Rune for an existing project — scaffolds docs/ topology, generates codemap (incl. module index), creates feature catalog (incl. component/decision sections) with Pre-Rune entries, writes adoption ADR. One-time setup for brownfield projects. |
为已有项目接入 Rune 文档拓扑。一次性脚手架，生成 Rune 工作流期望的目录结构和机械文档。不反推 spec，不创造虚假历史。
启动时公告： "使用 onboard skill 为本项目搭建 Rune 文档拓扑。"
自动检测，不问用户。
检测项：
.py / .ts / .go / .rs / .java 等）package.json / pyproject.toml / go.mod / Cargo.toml 等）find . -maxdepth 2 -type d（排除 node_modules、.git、pycache）向用户展示扫描结果摘要（语言、框架、源码结构、已有文档列表）。
基于 Step 1 目录扫描推断模块划分。归组规则：
src/ 下直接子目录 → 每个是一个模块__init__.py 的目录）→ 每个是一个模块.go 文件的目录）→ 每个是一个模块向用户展示推断结果，请求确认或调整。不跳过。
先盘点用户现有的文档结构，不移动任何已有文件：
docs/architecture/docs/ → 列出现有子目录、与 Rune 期望子目录（specs / designs / architecture/adr / changes）对比，标记缺失项向用户报告评估结果与待补缺失子目录列表。
基于 Step 3 评估结果，仅创建缺失的 Rune 子目录：
mkdir -p docs/specs docs/designs docs/architecture/adr docs/changes docs/changes/archive
mkdir -p 对已存在的目录是 no-op，但 Step 3 评估结果必须作为前置——避免在用户已有自定义 docs/ 结构（如 docs/api/、docs/guides/）时无差别注入空目录而无告知。
docs/changes/ 存活跃工作单元（<feature>/）；docs/changes/archive/ 存完成后归档（proposal.md + specs.md）。
按 doc-ops sync 的 codemap 格式（docs/CODEMAP.md）生成。从源码结构机械提取：
[待补充]）package.json / requirements.txt / go.mod 解析）无法机械推断的字段填 [待补充]，不猜测。
调用 doc-ops skill（write 模式，模板：adr）写入：
此 ADR 在 Step 7 注册进 FEATURE-CATALOG 的 Decisions 段。
按 doc-ops sync 的格式创建 docs/FEATURE-CATALOG.md，含三段：
询问用户列出主要已有功能（3-10 个），以 Pre-Rune 状态写入：
| feature-name | Pre-Rune | — | — | Done |
字段语义（Pre-Rune 行所有字段都由 "Pre-Rune" 隐含，按 schema 占位）：
docs/specs/<capability>-spec.md）不要试图给 Pre-Rune 行填其他值。用户可跳过（直接回车），Features 段留空。
非 UI 项目省略本段。UI 项目留空表头，后续由 design-workflow 填充。
预填 Step 6 写入的 ADR-0001：
| 0001 | Adopt Rune for Development Workflow | 已批准 | YYYY-MM-DD | — |
docs/specs/、docs/designs/、docs/architecture/adr/、docs/changes/ 及 CODEMAP / FEATURE-CATALOG / ADR-0001）specs/ 按 capability 组织（<capability>-spec.md），随 feature/bug 触及时由 brainstorm 逐步补建，不在 onboard 批量生成NEVER：
ALWAYS：
[待补充]