wiki-maintain

name	wiki-maintain
description	Full wiki housekeeping pipeline: lint, then consolidate duplicates/stale atoms, then restructure taxonomy if needed. User confirms before each write phase. Not for routine read, capture, or ingest.
disable-model-invocation	true

wiki-maintain

Default: run the full pipeline when user invokes /wiki-maintain (no sub-command).

Read ../_shared/disclosure.md and supporting/restructure-patterns.md when restructuring.

Optional arg: category filter or time hint for consolidate, e.g. /wiki-maintain skills.

Pipeline (always in order)

Do not stop after lint and ask which mode — run all phases below in one session.

Phase 1 — Lint (read-only)

1. Run scripts/run-maintain.sh or scripts/run-lint.sh (includes bound check). Stop if unbound.
2. Run scripts/run-maintain.sh "<optional filter>" or scripts/run-lint.sh then scripts/gather-consolidate.sh.
3. Parse lint JSON; group issues by kind.
4. Briefly report issue count and top problems.

Phase 2 — Consolidate (plan → confirm → apply)

Always run this phase after lint (even if lint is clean).

1. From gather output + lint, wiki peek relevant atoms and recent raw/dialogs/ (peek only).
2. Draft a consolidate plan:
   • merge — same topic / redundant atoms → one atom
   • deprecate — outdated entries (note in plan; no delete without confirm)
   • profile — lines to add/remove in profile.md
   • fix — missing summary / head / broken fields lint flagged (if trivial)
3. If plan is empty: print Consolidate: nothing to do. and continue to Phase 3.
4. Otherwise show plan table to user — stop if declined.
5. Apply confirmed edits; append log.md (## [date] consolidate | summary); wiki refresh.

Phase 3 — Restructure (plan → confirm → apply)

Always evaluate after consolidate.

1. From lint (atom_orphan, atom_missing_category, duplicate/overlapping category/aspect values) and index.md taxonomy, draft a JSON mapping when renames/merges are warranted, e.g. {"日常":"个人","生活":"个人"}.
2. If no mapping needed: print Restructure: nothing to do. and go to Phase 4.
3. wiki plan-restructure --mapping '<json>' — show affected pages.
4. User confirms — stop if declined.
5. wiki apply-restructure --mapping '<json>'
6. Update schema.md notes, index.md, append log.md, wiki refresh.

Phase 4 — Verify

1. wiki lint --fix-hints again.
2. Summarize: lint before/after, consolidate changes, restructure changes.

Override modes (only if user names one)

User says	Skip to
"只 lint" / "lint only"	Phase 1 + Phase 4
"只合并" / "consolidate only"	Phase 2
"只改分类" / "restructure only"	Phase 3

Stop

• Phase 4 summary delivered, or user declines a write phase (earlier phases already applied stand).