用途:为任意语言的代码编写、结构设计、重构与审查提供统一规范,目标是产出同事能读懂的代码:目录结构体现领域、文件小而单一职责、领域概念用显式类型、控制流直接、命名普通,并在代码无法表达原因处补充说明。审查、审计或检查类请求只返回发现,不做修改;变更请求只包含相关的本地检查,不做仓库级迁移、清理或重构,途中发现的既有问题作为后续事项写入总结。
主要能力:从仓库出发,先读项目说明、语言与运行时支持范围、依赖约束、邻近实现与测试及已配置检查,再决定语法、布局与工具;保持既有公开导入、输入、序列化值与持久化数据兼容,除非请求包含迁移。优先级为当前请求、项目书面规则与仓库约束、本技能默认值。命名职责:每个函数有调用方可见的单一职责,数据流与副作用清晰;边界不清时可用带类型签名与简短契约注释的骨架先暴露边界。结构上按领域优先、领域内按职责拆分目录;文件约 500 行手写代码时在可命名边界处拆分,超过 1000 行需在变更总结中说明理由。抽象按触发条件引入:集成出现第二种实现、设计文档指定的接缝、第二个入口点或需要 mock 供应商库的检查;单一实现不建接口,CRUD 不套仓储,组合根一屏内不引入依赖注入容器。领域模型用显式类型:封闭集合用枚举并带稳定外部值,跨数据边界的记录在边界处解析一次,同形标识符或单位用独立类型。使用语言当前标准设施并尽量标注类型。
使用方式:实现遵循已接受的设计文档(如 design-doc 技能产出)中的接缝表、验证拆分与运行边界;无此类文档时不臆造端口。LLM 智能体循环以任务契约为接口,循环本身作为适配器,工具各自置于端口后,预算、终止与权限为普通决策代码而非提示文本,输出轨迹记录供评估打分。文档只写代码无法展示的内容:文件头说明归属、类型文档说明角色与不变量、函数文档说明契约。仅文档或注释请求不得改动签名、注解、控制流或依赖;Python 可用 python3 <skill-dir>/scripts/verify_doc_only_diff.py --base HEAD -- path/to/file.py 校验。
验证与限制:通过真实入口点在固定输入上验证,留下可重跑的命令、输入与输出路径;分别报告代码是否运行、质量是否确立、是否已部署。默认不新增测试,仅对关键模块契约(解析器接受与拒绝边界、序列化格式、错误映射、智能体循环预算与权限检查等)添加测试,且由未见实现的子代理按接口契约以 Detroit 风格编写。格式化器不能证明运行时正确性,类型检查器不能证明外部数据校验,复杂度检查通过不能证明函数可读。资料未提供具体收费、价格、平台与效果信息。