用途:为 Claude Code 提供动态的多仓库与 monorepo 感知能力。当项目由相互独立的前端/后端仓库或多个应用的 monorepo 组成时,Claude Code 默认在隔离环境中工作,不了解模块间的 API 契约、共享类型与接口、整体系统架构、跨仓库依赖,以及其他部分发生的变更,易导致类型定义重复、API 契约不匹配、破坏性变更到运行时才暴露、重复实现已有能力。本技能通过动态分析工作区并经由 hook 保持上下文产物新鲜来解决这一问题。
主要能力:提供 /analyze-workspace 全量分析(约 2 分钟),包含拓扑发现(monorepo 与多仓库判别)、依赖图(谁调用谁)、契约提取(OpenAPI、GraphQL、类型)与关键文件识别;提供 /sync-contracts 增量同步(约 15 秒),检查契约源文件变更、将差异更新至 CONTRACTS.md 并做一致性校验。Hook 自动执行:会话开始时给出过期提醒(约 5 秒),提交后若契约变更则自动同步(约 15 秒),推送前做校验门禁(约 10 秒)。工作区分类支持 monorepo、多仓库、混合型与单一型,并可做多语言检测。
使用方式:在 Claude Code 中调用上述命令,分析产物输出至 _project_specs/workspace/,包括 TOPOLOGY.md、CONTRACTS.md、DEPENDENCY_GRAPH.md、KEY_FILES.md、CROSS_REPO_INDEX.md 与 .contract-sources。关键文件按上下文分组并按 token 预算给出加载建议,支持按需触发加载。
适用场景:跨仓库或 monorepo 中修改 API 调用、类型定义、数据库 schema、认证流程,或需要检查契约一致性时。
限制:资料未提供具体安装命令、价格、平台支持范围与实测效果数据;分析耗时与 token 估算为文档中给出的说明性数值。