这是一个面向代码库架构的 Agent 技能，名称在资料中呈现为 ai-codebase-deep-modules，来源标识为 tristanmanchester/agent-skills。它的目标是设计或重构高内聚模块：用小型但有用的公共契约隐藏真正的复杂度，并让依赖边界可被强制执行。核心理念是降低认知与变更成本，同时保持既有行为，而不是增加文件夹、规定导出数量，或给每个函数套一层抽象。
使用方式上，它强调先检查真实的变更路径：从任务出发，追踪相关入口点经过领域策略、状态与数据归属、副作用、调用方和测试；读取实际依赖，而不只依赖 README 中的架构描述；识别调用方必须知道的信息，以及反复出现的联动编辑。资料特别提醒，大文件可以是高内聚的，很小的包装也可能泄漏复杂协议，不应把代码行数与模块深度等同。
在契约设计方面，该技能建议围绕归属定义操作、输入输出类型、错误、状态转换、资源所有权、生命周期、权限以及并发与取消语义；让不变量保留在拥有它的模块内；把外部边界处的校验与内部已校验值分开，避免到处重复防御性检查。它主张暴露领域操作，而不是一堆内部实现或一个万能 manager；公共入口点可以是一种有用的约定，但类型、平台适配器、懒加载或服务端/客户端边界可能更适合多个有意设计的表面。应避免会改变导入副作用或把服务端专用代码打进客户端包的巨型根 barrel，并保留语言或框架真实的加载契约。
依赖方向上，应绘制显式的依赖方向；通过另一个领域公共契约建立的直接无环依赖，可能比新引入事件总线更简单。只有依赖或归属问题需要时才使用反转，只有时间解耦确实有用时才使用事件。事件会带来投递、顺序、幂等和可观测性义务，并不会让耦合消失。共享代码应真正共享，而不是成为所有争议类型的堆放地。
边界执行与测试方面，资料建议先阅读边界强制执行方式，再编写 lint 规则；规则必须能区分模块使用自身内部实现与外部消费者跨越边界。应通过所有受支持的拼写与解析器测试允许和禁止的导入。文件名、all 和 grep 只是约定或信号，不是通用的隐私或安全机制。应在公共边界创建行为测试，覆盖有意义的失败、空或边界数据、状态与重启、取消以及并发等适用情形；当内部测试能诊断重要算法时可保留聚焦的内部测试。模拟实现自身调用序列的 mock 不能证明其契约，返回未实现的 stub 测试也不等于实现了领域行为。应先用最快的相关测试、lint 和类型检查，再走重构实际触及的构建或集成路径；衡量反馈成本与正确性，而不是固定的 mock 或文件配额。
重构应作为一次连贯变更：把已有的模块示例当作草图而不是原样安装的脚手架；同步更新接口、实现、消费方、依赖规则和测试；在没有消费方契约要求时，不要创建兼容别名、死包装、投机导出或第二套实现。破坏性的数据或模式迁移仍然需要明确的上线或恢复计划；移除源码兼容并不等于可以丢数据。资料说明旧的 scaffold_deep_module.py 已被移除，因为它会把未检查的名称插入路径和源码、跳过已存在文件却报告为已创建、生成占位 API 与测试而非有用的领域契约。应通过正常的评审补丁流程创建实际请求的文件，不需要替代 CLI 来生成四个空文件。
交付证据方面，应解释接缝、它隐藏了什么、允许哪些依赖，以及为何能减少具体的变更负担；报告实际运行的测试与未解决的集成风险；不能因为一个导入示例失败就声称实现了架构强制，也不能在没有对比任务测量的情况下声称 agent 速度提升。项目特定假设应显式说明，避免一刀切的整洁架构重写。资料末尾提到参考链接相对于已安装技能，作者基线评审于 2026-09-13，当前语言或 linter 来源记录在边界参考中。
适用场景：需要具体架构设计、降低耦合、去除重复、建立可强制执行依赖边界，或评估重构反馈速度的代码库工作。限制：安装命令、收费与价格、平台支持、详细使用步骤等事实在资料中暂未提供。