← ClaudeAtlas

docs-cockpit-buildlisted

Build a docs-cockpit project's documentation-association system from scratch or fill its gaps — scan ALL project docs, infer which module/subtask should link to which spec/plan/rfc section, dry-run-verify the anchors, then write them. Defaults to planning the WHOLE project (every module's spec/plan), deciding each linkage WITH the user in dialogue. Produces module↔subtask↔doc anchors + drafts missing spec/plan docs, then renders the dashboard. Also owns cockpit setup itself: creating/extending docs-cockpit.yaml, wiring scan dirs, and debugging build issues (0 modules / yaml errors) — its Phase 0. TRIGGER when the user wants to: 「把项目文档体系建起来」「关联模块和任务/文档」「规划整个项目的 spec/plan」「给所有 module 补 anchor」「这些 subtask 该关联哪个文档」 / "build the doc association", "wire modules to specs", "plan the whole project's docs", "add anchors to every module". Setup/debug phrasings: 「把项目做成 dashboard / 项目看板」「搭一个 docs-cockpit」「扩展 config 扫描新目录」「为什么扫出来 0 个 module」 / "set up a docs-cockpit", "extend the config to scan new dirs", "debug build iss
Guohao1020/docs-cockpit · ★ 2 · Data & Documents · score 75
Install: claude install-skill Guohao1020/docs-cockpit
# docs-cockpit-build **The 7-phase workflow for building a project's module ↔ subtask ↔ spec/plan/RFC association system, from nothing (or from gaps) to a rendered dashboard.** ## Why this skill exists The hard part of a docs cockpit was never the rendering — it's the association: which subtask is backed by which plan section, which module's spec actually exists, which RFC explains a decision. That is **cognitive work** (search, read, judge), and trying to encode it in Python produced exactly the failure mode users reported: modules with no docs linkage, subtasks pointing nowhere, and no highlighted evidence for why a link exists. So the v1.0 north-star: **cognition lives in skills; Python only renders**. This skill is the cognition — it orchestrates four atomic methods (discovery / reasoning / dry-run / highlight) and a dialogue loop with the user, then hands a fully-anchored doc set to the rendering CLI. One principle governs every phase: **a wrong anchor is worse than a missing anchor.** A missing anchor is an honest gap; a wrong one sends the user to irrelevant content and destroys trust in the whole dashboard. When in doubt, mark the gap and ask — never guess line numbers. ## How this skill is layered This skill is the **orchestration layer** — it tells you which phase to run when. The details live in references (do not restate them; read them when the phase needs them): | Reference | Holds | Used by | |---|---|---| | `references/schema.md` | frontmatter fields ·