gewuyou 1239fb4651 refactor(skills): 统一文档刷新技能入口
- 新增 gframework-doc-refresh 统一技能入口,并补齐模块扫描、证据顺序、模板与校验脚本

- 更新共享文档规范与模块映射,收口源码模块到 README、docs 和 ai-libs 的固定关联

- 删除旧 vitepress-* 公开技能定义,避免继续以文档类型拆分入口

- 同步 documentation-governance-and-refresh 的恢复点、风险和下一步
2026-04-22 09:13:22 +08:00
..

AI-Plan Public Index

ai-plan/public/README.md is the shared startup index for boot. It should stay short, list only active topics, and help the current worktree land on the right recovery documents without scanning every public artifact.

Boot Rules

  1. Read this file before scanning ai-plan/public/<topic>/.
  2. If the current branch or worktree appears in the map below, read the listed topics in priority order.
  3. If there is no match, fall back to scanning active topic directories.
  4. Ignore ai-plan/public/archive/** by default unless the user explicitly asks for historical context.

Active Topics

  • analyzer-warning-reduction
    • Purpose: track the analyzer warning reduction branch, including the current recovery point, remaining warning hotspots, and the next safe warning-reduction slice.
    • Tracking: ai-plan/public/analyzer-warning-reduction/todos/analyzer-warning-reduction-tracking.md
    • Trace: ai-plan/public/analyzer-warning-reduction/traces/analyzer-warning-reduction-trace.md
  • ai-plan-governance
    • Purpose: govern the ai-plan/ directory model, startup index, and archive policy.
    • Tracking: ai-plan/public/ai-plan-governance/todos/ai-plan-governance-tracking.md
    • Trace: ai-plan/public/ai-plan-governance/traces/ai-plan-governance-trace.md
  • ai-first-config-system
    • Purpose: continue the AI-First config runtime, generator, and consumer DX work for GFramework.Game.
    • Tracking: ai-plan/public/ai-first-config-system/todos/ai-first-config-system-tracking.md
    • Trace: ai-plan/public/ai-first-config-system/traces/ai-first-config-system-trace.md
  • coroutine-optimization
    • Purpose: continue the coroutine semantics, host integration, observability, regression coverage, and migration-doc follow-up work.
    • Tracking: ai-plan/public/coroutine-optimization/todos/coroutine-optimization-tracking.md
    • Trace: ai-plan/public/coroutine-optimization/traces/coroutine-optimization-trace.md
  • cqrs-rewrite
    • Purpose: continue the CQRS migration, registry hardening, and related PR follow-up.
    • Tracking: ai-plan/public/cqrs-rewrite/todos/cqrs-rewrite-migration-tracking.md
    • Trace: ai-plan/public/cqrs-rewrite/traces/cqrs-rewrite-migration-trace.md
  • data-repository-persistence
    • Purpose: continue the data repository persistence hardening plus the settings / serialization follow-up backlog.
    • Tracking: ai-plan/public/data-repository-persistence/todos/data-repository-persistence-tracking.md
    • Trace: ai-plan/public/data-repository-persistence/traces/data-repository-persistence-trace.md
  • documentation-governance-and-refresh
    • Purpose: continue the documentation governance, README hardening, and docs/zh-CN accuracy refresh work.
    • Tracking: ai-plan/public/documentation-governance-and-refresh/todos/documentation-governance-and-refresh-tracking.md
    • Trace: ai-plan/public/documentation-governance-and-refresh/traces/documentation-governance-and-refresh-trace.md

Worktree To Active Topic Map

  • Branch: fix/analyzer-warning-reduction-batch
    • Worktree hint: GFramework-analyzer
    • Priority 1: analyzer-warning-reduction
  • Branch: feat/ai-first-config
    • Worktree hint: GFramework-Ai-First-Config
    • Priority 1: ai-first-config-system
  • Branch: feat/cqrs-optimization
    • Worktree hint: GFramework-cqrs
    • Priority 1: ai-plan-governance
    • Priority 2: cqrs-rewrite
  • Branch: feat/coroutine-optimization
    • Worktree hint: GFramework-coroutine-optimization
    • Priority 1: coroutine-optimization
    • Priority 2: ai-plan-governance
  • Branch: feat/data-repository-persistence
    • Worktree hint: GFramework-data-repository-persistence
    • Priority 1: data-repository-persistence
  • Branch: docs/sdk-update-documentation
    • Worktree hint: GFramework-update-documentation
    • Priority 1: documentation-governance-and-refresh

Archived Topics

  • cqrs-cache-docs-hardening
    • Archive root: ai-plan/public/archive/cqrs-cache-docs-hardening/
    • Note: archived topics stay outside the default boot context until a user explicitly requests historical review.