用途:key-guidelines 为代理提供一致、高质量的代码开发原则与标准,用于在执行开发任务时自动遵循统一的工程规范。
主要能力:设计原则覆盖 DRY(避免重复)、KISS(保持简单)、YAGNI(不提前实现未需要的功能,只在确有复用需求时抽取方法)、SOLID(单一职责、开闭、里氏替换、接口隔离、依赖倒置)以及 SoC(按关注点分离 UI、业务逻辑、数据访问等);开发方法采用 Kent Beck 风格 TDD 拆解任务,并遵循 Lucas Rocha 微提交方法,每次提交只含一处改动并严格执行测试驱动的变更循环;质量与标准要求在提交前运行 linter 与类型检查器,始终遵循安全指南并扫描漏洞,技术文档保存在 docs/ 目录,版本控制遵循约定式提交信息与分支策略。
使用方式:当宿主代理支持为该任务选择模型时,优先从环境中可用的模型里选择低成本、快速的模型,前提是它能可靠完成该任务;应使用宿主文档中记录的模型标识与选择机制,不要假定特定供应商或编造模型名与参数,并尊重用户和项目显式的模型设置;若无法选择模型或没有已知的合适替代,保持当前模型。将本指南应用于进行中的开发任务不需要切换模型或启动子代理。
限制:具体平台、价格与更多实现细节资料未提供。