go-modular-bricks

用途：面向采用 Bricks 模块化架构的 Go 服务，指导开发、维护或代码审查。\n\n主要原则与能力：先建立项目规则，阅读项目的 agent 指令与已记录的编码规范，遵循其指向的接口契约与已采纳的 ADR，使用项目自身的文档路径而非假设文件名，记录本地关于归属、错误、私有函数、注释、装配与测试的规则；本地规则优先于通用配方，邻近代码不构成违规授权。选择包前先分类：对每个新增或抽取的职责，在编辑前说明其行为、归属、目标文件与选定契约；审查时先分类再判断。职责与归属对应关系包括：公共业务操作与编排（用例、application router）；操作局部输入形状约束（用例输入校验、application router）；可复用接受/拒绝规则含需外部数据的检查（validator/ 加消费者自有的 ports/<name>_validator.go、validators）；表示转换含解析与集合组装（边界自有的 mapper/、mappers）；持久化、远程协议适配或供应商集成（分别为 repository、client、provider、application router）；无更具体归属的可复用能力（service/、services）。loader 拥有 I/O，将可复用检查委托给 validator、将抽出的转换委托给 mapper；私有方法必须实现接收者自身职责。按职责路由：先从任务与所属代码识别被变更、诊断或审查的边界；端点背后的 SQL 修复属持久化任务而非自动归为 REST；归属未知时先追踪失败路径。router 对应 HTTP DTO、handler、路由、中间件、集合查询、API 文档（REST）；Cobra 业务命令、服务器或迁移命令行为（CLI）；用例、类型、映射、端口、适配器、schema、Fx、配置、归属、资源、遥测、测试（Application）。加载边界时选择匹配行与触发的伴随项，混合任务取并集，路径相对于所在文档解析，编辑或判断前完整阅读所选契约；检查调用方与依赖时不自动加载其专家内容，仅在受影响职责或特定未验证保证时扩展；链接是条件指针而非递归阅读清单。仅测试工作选择证明接缝与断言行为的专家内容；仅文档工作选择其主题；审查选择所有被判断的边界。完成前验证归属：按函数体对每个新增或变更的函数与方法重新分类（含私有方法与仅辅助文件），与所选归属与文件匹配，完成前抽出错放的校验与映射，然后验证公共表示、受影响的运行时注册、项目错误模式与项目选定的测试接缝；若 diff 扩大则重新选择契约。运行项目配置的必需 lint、架构检查、测试与独立审查，逐项报告通过、失败或未运行并附证据或阻碍；缺少工具不能判为通过，自审不能替代独立审查；所有必需检查通过且每个受影响边界满足契约前，任务保持未完成。修复实现；修改批准规则或弱化测试需要明确授权。限制：本技能资料未提供具体安装命令、代码示例、适用平台、价格或效果信息；这些内容暂未提供。