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

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

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

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

1.8 KiB

Startup Artifacts

Required Reads

  • AGENTS.md
  • .ai/environment/tools.ai.yaml
  • ai-plan/public/README.md
  • the selected ai-plan/public/<topic>/todos/ directories
  • the selected ai-plan/public/<topic>/traces/ directories

AI-Plan Selection Heuristics

  • Match the current branch or worktree against ai-plan/public/README.md first.
  • If the index maps the current worktree to topics, inspect those topics in listed order before scanning anything else.
  • Match the user's wording against public todo and trace file names next.
  • Prefer the newest matching trace when several candidates describe the same feature area.
  • If one file records a clearer recovery point than a newer but vague file, prefer the clearer recovery point.
  • Ignore ai-plan/public/archive/** unless the user explicitly requests historical recovery context.
  • Even inside an active topic, prefer the root todos/ and traces/ entry files first; only read archive/ when the active files point there or when the user asks for historical detail.
  • If a matching ai-plan/private/<branch-or-worktree>/ directory exists, use it only as private context for the current worktree.

Complexity Defaults

  • simple: keep everything local, no subagent
  • medium: keep design local, optionally use one explorer for parallel read-only discovery
  • complex: keep architecture and integration local, delegate only bounded non-blocking subtasks

Model Defaults

  • explorer: gpt-5.1-codex-mini
  • worker: gpt-5.4

Startup Summary Template

Use a short update before execution:

Read AGENTS.md, the environment inventory, ai-plan/public/README.md, and the relevant public ai-plan artifacts. This looks like a <task-state> <complexity> task. I will <delegate-or-not> and start with <first-step>.