用途:当用户要求梳理代码库时,分析整个代码库,在 .planning/codebase/ 生成 7 份文档:STACK.md(技术、依赖、配置)、INTEGRATIONS.md(第三方服务、API、数据库、认证)、ARCHITECTURE.md(系统模式、分层、数据流)、STRUCTURE.md(目录布局、关键位置、命名约定)、CONVENTIONS.md(代码风格、模式、错误处理)、TESTING.md(框架、结构、Mock、覆盖率)、CONCERNS.md(技术债、缺陷、安全、性能问题)。适用于新人上手、规划新功能、变更前了解约定、识别技术债和记录项目现状。
用法:执行 mkdir -p .planning/codebase 创建目录,然后运行四个焦点遍次——Tech(STACK、INTEGRATIONS)、Architecture(ARCHITECTURE、STRUCTURE)、Quality(CONVENTIONS、TESTING)、Concerns(CONCERNS)。运行时支持文件读写 worker 时可并行,否则在当前上下文顺序执行;每个遍次按 $SKILL_PATH/templates/ 模板探索并直接写文档,只返回确认。支持可选 --paths <p1,p2,...> 做增量映射,需校验仓库相对前缀,拒绝绝对路径、.. 和 shell 元字符;无有效路径则停止询问,不静默扩大范围。若 .planning/codebase/ 已存在,提示 Refresh/Update/Skip。完成后用 ls -la 和 wc -l 验证 7 份文档均存在且超过 20 行,再做密钥检查(列出配置路径与环境变量名,不读 .env,不复制密钥值),通过后可选提交。
限制:并行 worker 为可选而非必需;模板位于 $SKILL_PATH/templates/;模式匹配不能证明不存在密钥;日期须用当前实际日期。其余细节暂未提供。