codebase-overview

用途：分析现有代码库架构并产出架构概览文档，写入 ./.gtd/CODEBASE.md。支持两种模式：全新生成；带 --refresh 参数时加载已有文档并与当前代码库对比，仅更新变化部分。\n\n主要能力与流程：先检查是否含 --refresh，随后进入发现阶段——扫描项目根目录（ls -la，读取 package.json、Cargo.toml、go.mod、requirements.txt 等清单）、用 find 查看目录结构、按约定查找入口点、再生成并运行考古式分析任务，产出技术栈摘要、模块分类表、入口点清单、观察到的模式与开放问题。\n\n产出文档包含：技术栈表、带注释的项目结构、模块（路径、类型、用途、关键文件）、入口点表、模式与约定、关键依赖、开放问题。\n\n原则：只记录事实而非应然；广度优先，仅在模块为核心、命名不清或多入口汇聚时深入；不凭模块名猜测功能；每条结论需引用证据（如清单文件、函数签名、至少两个文件佐证），无法验证的写入 Open Questions；文档为活文档，重大重构、新增领域或执行 --refresh 时更新。\n\n限制：仅基于已有材料描述，实际运行效果、成本与平台支持暂未提供；涉及具体命令保持原样。