菜单
Refresh INDEX.md files for documents that have changed. Use after editing canonical spec documents to keep indexes up-to-date. Can refresh specific files or auto-detect stale indexes.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
This skill should be used when the user asks to "replace a module", "migrate a subsystem", "rewrite a pass", "swap an implementation", "strangle a component", "incremental migration", "replace without breaking", "phase out old code", "deprecate and replace", or "transition from old to new implementation". Provides a gate-test-driven migration state machine designed for convergence under repeated agentic execution.
Analyze architecture/spec documents for contradictions, ambiguities, and inconsistencies. Produces an encyclopedia-style canonical specification series. Use when user asks to canonicalize docs, find contradictions in specs, create a canonical spec, or consolidate design documents. Input is a directory or file list (e.g., "design-docs/" or "spec.md arch.md api.md").
Generate dense, token-efficient indexes of documents for fast contradiction detection. Use when indexing docs for canonicalize-architecture, compressing specs for analysis, or creating navigable summaries. Works on any markdown documents.
Motion (Framer Motion) React animation library. Use for drag-and-drop, scroll animations, gestures, SVG morphing, or encountering bundle size, complex transitions, spring physics errors.
Activates when the user asks about Agent Skills, wants to find reusable AI capabilities, needs to install skills, or mentions skills for Claude. Use for discovering, retrieving, and installing skills.
This skill should be used when the user asks to "run a gap analysis", "compare implementation to spec", "what's missing from the spec", "bring the app up to spec", "audit against spec", "find spec gaps", or wants to understand what work remains to make an implementation match its specification. Produces a structured delta document with dependency ordering and priority categories.
| name | refresh-indexes |
| description | Refresh INDEX.md files for documents that have changed. Use after editing canonical spec documents to keep indexes up-to-date. Can refresh specific files or auto-detect stale indexes. |
| model | claude-haiku-4-5 |
| allowed-tools | Read, Write, Bash, Glob |
After editing canonical specification documents, detect which indexes are stale and refresh them.
scripts/validate-indexes.sh to find which indexes are out of date/doc-index commands needed to refresh them/doc-index for each stale source fileYou edit a document, then invoke this skill:
User: [edits design-docs/.../time-system.md]
User: /refresh-indexes
The skill:
/doc-index design-docs/.../time-system.md"This keeps the workflow transparent - you see exactly what's stale and what needs to be refreshed.
Always invoke after editing canonical spec documents:
.md file in design-docs/CANONICAL-oscilla-v2.5-20260109/Example workflow:
# You edit a file
$ nano design-docs/CANONICAL-oscilla-v2.5-20260109/topics/03-time-system.md
$ # (make changes, save)
# Then invoke refresh-indexes to detect what's stale
$ /refresh-indexes
# Output tells you to run:
# /doc-index design-docs/CANONICAL-oscilla-v2.5-20260109/topics/03-time-system.md
# Run that command to regenerate the index
$ /doc-index design-docs/CANONICAL-oscilla-v2.5-20260109/topics/03-time-system.md
# Verify with validate-indexes
$ scripts/validate-indexes.sh
scripts/validate-indexes.sh:
source_hash in INDEX.md frontmatter to current source file hash (SHA256)This is why we must run /doc-index after editing - it regenerates the index with updated source_hash.
When you run /refresh-indexes:
🔍 Detecting stale indexes...
Stale indexes found:
- 03-time-system.INDEX.md
- INVARIANTS.INDEX.md
════════════════════════════════════════
Ready to refresh: 2 indexes
📋 To complete the refresh, run these commands:
/doc-index design-docs/CANONICAL-oscilla-v2.5-20260109/topics/03-time-system.md
/doc-index design-docs/CANONICAL-oscilla-v2.5-20260109/INVARIANTS.md
════════════════════════════════════════
You then copy/paste those /doc-index commands to regenerate the indexes.