菜单
Use when existing `.aoa` session archives need generated segment Markdown and indexes rebuilt from preserved raw JSONL after taxonomy, classifier, relationship, or index-schema changes.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Use when a `.aoa` session-memory root must be created, installed, checked, repaired, or prepared for Codex hook-based session archiving.
Use when an indexed `.aoa` session needs provisional first-pass distillation into lessons, decisions, failures, and automation candidates without promoting them to reviewed truth.
Use when an agent needs evidence from prior `.aoa` sessions about how a skill, MCP, hook, tool, API, goal, eval, test, validator, script, decision, error, receipt, or other recurring operational entity was used, what happened nearby, and which raw or segment refs prove it.
Use in any Codex session when the user mentions `.aoa`, session memory, Codex transcripts, compaction, prior session rehydration, hook failures, or AoA session-memory validation.
Use when an agent needs to build or query the portable `.aoa` SQLite search index for archived Codex sessions, with evidence refs and freshness checks.
Use when the live Codex PreCompact and PostCompact hook path must be proven through `.aoa` using the Codex app-server compact probe.
| name | aoa-session-reindex |
| description | Use when existing `.aoa` session archives need generated segment Markdown and indexes rebuilt from preserved raw JSONL after taxonomy, classifier, relationship, or index-schema changes. |
| license | Apache-2.0 |
| metadata | {"aoa_scope":"session-memory","aoa_invocation_mode":"manual"} |
Use this when the archive already has raw JSONL but generated segment indexes need to be regenerated under the current classifier.
segments/*.index.json without re-importing raw.Start with a dry run:
python3 scripts/aoa_session_memory.py reindex-sessions all \
--workspace-root <workspace-root> \
--aoa-root <aoa-root> \
--dry-run \
--write-report
For a bounded smoke pass:
python3 scripts/aoa_session_memory.py reindex-sessions all \
--workspace-root <workspace-root> \
--aoa-root <aoa-root> \
--limit 10 \
--write-report
For one target session:
python3 scripts/aoa_session_memory.py reindex-sessions <session-label-or-id> \
--workspace-root <workspace-root> \
--aoa-root <aoa-root> \
--write-report
After a classifier or schema reindex, refresh generated projections through the named catch-up route:
python3 scripts/aoa_session_memory.py projection-catchup all \
--workspace-root <workspace-root> \
--aoa-root <aoa-root> \
--apply \
--write-report
Use --profile deep only when the catch-up payload reports that a heavy full
search rebuild or graph repair is required.
counts.diagnostic is absent or zero.by_family, by_phase, by_actor,
by_action, by_outcome, and by_correlation.projection-catchup reports no remaining projection backlog, or returns the
explicit next route needed to finish it.projection-status reads the latest projection-catchup completeness packet
without running the writer route, and uses cached maintenance diagnostics
unless --refresh-maintenance is explicitly requested.doctor, audit, and tests after broad reindexing.Do not delete raw JSONL or distillation artifacts. Reindex regenerates generated segments and indexes from raw evidence; it is not a semantic promotion step.