Agent Lean Safe Coding
使用此技能让编码代理既精简又安全:只构建所需的行为,重用已有内容,并保护 Windows/文本密集型仓库免受脆弱的编辑影响。
默认模式为 full。
lite:快速分类,狭窄上下文,最小的安全补丁。full:分诊阶梯,Windows/文本安全保护层,依赖检查,补丁预算,验证。audit:不进行编辑;审查计划或差异,检查过度构建、重复逻辑、依赖风险、Windows/文本风险以及验证不足。
运行时循环
- 对任务进行分类。
- 将有风险的文件放入安全保护层。
- 在编写代码之前走一遍分诊阶梯。
- 设定一个补丁预算。
- 本地编辑并保持风格一致。
- 验证最小的目标门。
- 报告结果,附上重用和风险说明。
1. 分类
在编辑之前命名任务类型:
bugfix:找出共同原因;在撒布防护代码之前检查同级调用者。feature:检查所请求的行为是否已由平台、框架或仓库提供。refactor:需要具体的简化或风险降低;避免为了个人偏好而重新排列代码。review:指出删除、重用机会、不安全的 shell/文本操作以及缺失的检查。docs/text:保护编码、行尾、Markdown 结构和示例。
如果请求不明确但保守的默认行为是安全的,则使用该默认行为进行,并简要说明假设。
2. 安全保护层
当以下任何情况出现时,使用安全保护层:Windows 路径、PowerShell 或 cmd、非 ASCII 文本、中文文本、表情符号、Markdown、提示、模板、本地化文件、精确替换、不确定的编码、CRLF/LF 敏感文件,或可能被误认为是源代码的生成输出。
在安全保护层内:
- 优先使用补丁工具进行小的编辑。
- 避免将非 ASCII 内容通过 shell 管道或内联 PowerShell 字符串传递。
- 保留现有的换行符样式,除非格式化工具管理该文件。
- 对脚本使用路径 API 或带引号的文字路径。
- 将控制台乱码仅视为显示证据;在重写之前检查字节或 UTF-8 读取。
- 除非用户明确要求,否则不要编辑生成的文件夹、依赖文件夹、缓存、二进制文件、截图或归档文件。
仅当任务涉及编码、换行符、路径或 shell 脆弱性风险时,才阅读 references/windows-text-safety.md。
3. 分诊阶梯
在自定义代码之前,停留在能干净解决问题的第一个层级:
- 消除需求:能否通过删除、配置或记录现有路径来满足请求?
- 重用项目代码:辅助函数、组件、钩子、验证器、测试工具、命令、模式或已有模式。
- 使用语言或标准库行为。
- 使用平台或框架行为:浏览器控件、CSS、数据库约束、框架路由、验证、缓存、序列化或构建工具。
- 使用已安装的依赖项。
- 添加一个极小的本地实现。
- 仅在给出明确理由、风险和审批要求时,才提议新的依赖项或更大的实现。
切勿自动添加生产依赖项。如果新的依赖项看起来合理,请解释它将替代什么、为什么已安装的选项不合适、维护风险以及确切的安装命令。
仅当依赖/重用决策不明确时,才阅读 references/reuse-ladder.md。
4. 补丁预算
在编辑之前,选择一个小的预算:
- 预期要更改的文件。
- 有意保持原样的文件。
- 要重用的现有代码或平台功能。
- 最小的验证命令,或无需命令的理由。
优先选择更少的文件、更少的抽象,以及靠近行为的直接更改。不要添加接口、工厂、服务层、配置开关、未来的扩展点或包装器,除非当前任务需要它们。
5. 补丁规则
- 只修复根路径一次,而不是添加重复的调用侧变通方案。
- 在行为保持正确的情况下删除冗余代码。
- 保持差异中不出现格式变更。
- 保持注释稀少;仅当意图限制以后需要可见时才使用一个简洁的注释。
- 如果快捷方式有已知的上限,请在该注释中命名该上限以及升级触发器。
- 不要将一个小函数变成一个子系统。
6. 验证
运行证明变更的最窄的绿色门:
- 针对受影响行为的现有测试。
- 针对非平凡的新逻辑的集中单元测试或自我检查。
- 针对编辑过的语言文件(当测试不可用时)的语法/类型/ lint 检查。
- 针对仅文档或微小的一行变更的差异审查。
非平凡的分支、解析器、金钱/安全路径或数据丢失路径需要一个可运行的检查(当实际可行时)。微小的一行变更不需要新的测试脚手架。
7. 最终报告
保持最终报告简短:
已更改 - ...
分诊 - 已重用/标准库/平台/已安装的依赖项/本地代码/新的依赖项提议
安全性 - Windows/文本风险已处理或不相关
已验证 - 命令/结果或理由
风险 - 剩余限制(如果有)
对于 audit 模式,首先返回发现,尽可能附带文件/行引用,然后是一个删除/重用列表以及最小的验证差距。