菜单
Regenerate and query the Mycelium agent code index (docs/api-index/), and validate doc_refs entries in issues.yaml. Use when you need to regenerate the committed agent index, query it for symbol locations, or check doc_refs validity.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Generate the validated "read" (prose) that accompanies extracted code facts — language-book chapters, reference-manual entries, and learning-corpus lessons — from the committed index JSON, with a mandatory faithfulness gate so nothing is hallucinated. Wraps tools/llm-harness/narrate/ (Generator -> FaithfulnessChecker -> Loop): only validated, cited prose is committed; the rest is dropped and reported (never silently). Deterministic Mock backends by default (offline/CI).
Classify a Rust construct's Mycelium native-translation strategy using the ratified DN-111 native-equivalence taxonomy — Native Equivalent · Idiomatic Remapping · Approximation · Interop Bridge (DN-110's Adaptation/Solution/Approximation/Bridge handles are permanent aliases). Runs DN-110 §9's six-step decision procedure: verify-first against the corpus, identify the underlying PROBLEM (not Rust's mechanism), classify by the {exact?}×{native?} generator, apply the DN-109 §3.2 auto-fire ratchet, and emit a register-style record with an honest, never-upgraded guarantee tag (VR-5).
Reconcile the repo's GitHub issues to the committed source of truth (tools/github/issues.yaml + idmap.tsv) the rate-limit-frugal, diff-based way: one bulk snapshot, only-the-deltas writes, dry-run by default. Hits the API only for issues that are missing (create) or drifted (update), skipping everything already in sync. A periodic DESKTOP operation (real API) — not for the cloud/web session.
Maintain Mycelium's changelogs. Keeps the top-level CHANGELOG.md (Keep a Changelog 1.1.0, ISO dates, design-phase framing) and each doc's changelog footer in sync with a change, and enforces the append-only status discipline (Draft→Accepted→Superseded, Resolved for notes). Use when finishing a change, moving a doc's status, or cutting a release.
Develop a change forward (up the tiers) the spec-first, staged, context-windowed way: spec/DN (requirements, DoD, user stories) -> public API -> private API -> component seam-map -> code, each stage a bounded working set that persists a compact artifact and drops from context once consumed (DN-96). Owns the staged design pipeline, the change-sizing check (soft ~1-2k / hard 4,000 LOC), and the precursor doc/index-branch mechanic; delegates isolation, review+merge-up, index regen, and the main landing to /worktree-guard, /pr-land, /doc-index + /tero-refresh, and /land, following DN-97's ratified Rank-1 batch-engine command sequences for the actual landing.
Propagate a squashed landing on `main` back down to the persistent lower trunks -- main -> integration -> dev -- via a plain, no-force merge per tier (DN-97 Rank 1, maintainer-ratified: same-content trunks make this trivially conflict-free -- no merge-driver, no veto, no keep-list). Landed through the same PR-merge mechanism /pr-land and /land already use for these protected branches, never a raw git push. Run once per batch after 1-6 disjoint work-set squashes land on main. Also covers the in-flight-adapt one-liner for a still-open work-set branch.
| name | doc-index |
| description | Regenerate and query the Mycelium agent code index (docs/api-index/), and validate doc_refs entries in issues.yaml. Use when you need to regenerate the committed agent index, query it for symbol locations, or check doc_refs validity. |
| when_to_use | Use when regenerating docs/api-index/ after a public-API change, when querying for a symbol's location in source, when validating doc_refs: entries in issues.yaml, or when checking whether the committed index is current. |
| allowed-tools | Bash(python3:*), Bash(just:*), Read, Grep, Glob |
just docs-index # regenerate docs/api-index/ and commit the result
bash scripts/checks/doc-index.sh # drift gate: PASS if current, FAIL if stale
The drift gate is also wired into just check (after api). It runs skip-graceful
when python3 is absent.
docs/api-index/INDEX.md — grep-friendly table grouped by crate (for agent context)docs/api-index/index.json — machine-structured: symbol, file, line, summaryExample lookup: grep "binary::bits_to_int" docs/api-index/INDEX.md
In tools/github/issues.yaml, a doc_refs: list entry may be:
api:<crate>::<path> — a symbol in docs/api-index/index.json (checked against items)corpus:<DOC>[#<anchor>] — a doc/section in docs/Doc-Index.md; the anchor is a heading
slug heuristic (Empirical/Declared — may miss atypical headings)src:<path>[:<line>] — a source file location relative to repo root; if :<line> given,
line must exist in the fileValidate all refs:
python3 tools/github/doc_refs_check.py --issues-yaml tools/github/issues.yaml
The validator also runs as part of python3 tools/github/manifest-check.py.
The index is Empirical/Declared — a line/regex heuristic. Source is always ground truth.
Items the heuristic can't locate appear in the flagged section of index.json and
INDEX.md (G2: never silently dropped). This includes re-exports (pub use),
macro-generated items, and cfg-gated items.
Never claim the index is exact. Use it to find where to Read, then verify in source.
docs/api-index/ is orchestrator-owned — it is REGENERATED (never hand-merged) by the
integrating parent after any octopus merge that touched a public API, before pushing.