Communitygithub.com

AgentPilotLab/agent-lean-safe-coding

适用于 Codex、Claude Code 和 AI 代理的 Windows 安全精简编码技能和插件包。

agent-lean-safe-coding 是什么?

Agent Lean Safe Coding 技能旨在指导 AI 编码代理(如 Codex、Claude Code 等)生成更小、更安全的代码变更。它通过强制实施一个结构化的运行时流程来工作:先对任务进行分类,然后为 Windows 路径或非 ASCII 文本等风险场景设置“安全保护层”,接着执行“分诊阶梯”以优先重用现有代码而非从头编写新功能。在编辑前,它会设定一个小的“补丁预算”,并遵循严格的补丁规则以保持简洁性,最后通过最窄的验证门来确保正确性。该技能提供三种模式:`lite` 用于快速分类和小范围修复,`full` 作为包含所有安全检查的默认模式,以及 `audit` 用于审查计划或差异,而不作任何编辑。其最终报告会透明地记录所做的更改、重用的内容、安全问题以及任何剩余风险,这使其对于管理大型或跨平台代码库的开发者来说非常有用。

兼容平台✓Claude Code✓Codex CLI~Cursor
npx skills add AgentPilotLab/agent-lean-safe-coding

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Agent Lean Safe Coding

使用此技能让编码代理既精简又安全:只构建所需的行为,重用已有内容,并保护 Windows/文本密集型仓库免受脆弱的编辑影响。

默认模式为 full。

  • lite:快速分类,狭窄上下文,最小的安全补丁。
  • full:分诊阶梯,Windows/文本安全保护层,依赖检查,补丁预算,验证。
  • audit:不进行编辑;审查计划或差异,检查过度构建、重复逻辑、依赖风险、Windows/文本风险以及验证不足。

运行时循环

  1. 对任务进行分类。
  2. 将有风险的文件放入安全保护层。
  3. 在编写代码之前走一遍分诊阶梯。
  4. 设定一个补丁预算。
  5. 本地编辑并保持风格一致。
  6. 验证最小的目标门。
  7. 报告结果,附上重用和风险说明。

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. 分诊阶梯

在自定义代码之前,停留在能干净解决问题的第一个层级:

  1. 消除需求:能否通过删除、配置或记录现有路径来满足请求?
  2. 重用项目代码:辅助函数、组件、钩子、验证器、测试工具、命令、模式或已有模式。
  3. 使用语言或标准库行为。
  4. 使用平台或框架行为:浏览器控件、CSS、数据库约束、框架路由、验证、缓存、序列化或构建工具。
  5. 使用已安装的依赖项。
  6. 添加一个极小的本地实现。
  7. 仅在给出明确理由、风险和审批要求时,才提议新的依赖项或更大的实现。

切勿自动添加生产依赖项。如果新的依赖项看起来合理,请解释它将替代什么、为什么已安装的选项不合适、维护风险以及确切的安装命令。

仅当依赖/重用决策不明确时,才阅读 references/reuse-ladder.md。

4. 补丁预算

在编辑之前,选择一个小的预算:

  • 预期要更改的文件。
  • 有意保持原样的文件。
  • 要重用的现有代码或平台功能。
  • 最小的验证命令,或无需命令的理由。

优先选择更少的文件、更少的抽象,以及靠近行为的直接更改。不要添加接口、工厂、服务层、配置开关、未来的扩展点或包装器,除非当前任务需要它们。

5. 补丁规则

  • 只修复根路径一次,而不是添加重复的调用侧变通方案。
  • 在行为保持正确的情况下删除冗余代码。
  • 保持差异中不出现格式变更。
  • 保持注释稀少;仅当意图限制以后需要可见时才使用一个简洁的注释。
  • 如果快捷方式有已知的上限,请在该注释中命名该上限以及升级触发器。
  • 不要将一个小函数变成一个子系统。

6. 验证

运行证明变更的最窄的绿色门:

  • 针对受影响行为的现有测试。
  • 针对非平凡的新逻辑的集中单元测试或自我检查。
  • 针对编辑过的语言文件(当测试不可用时)的语法/类型/ lint 检查。
  • 针对仅文档或微小的一行变更的差异审查。

非平凡的分支、解析器、金钱/安全路径或数据丢失路径需要一个可运行的检查(当实际可行时)。微小的一行变更不需要新的测试脚手架。

7. 最终报告

保持最终报告简短:

已更改 - ...
分诊 - 已重用/标准库/平台/已安装的依赖项/本地代码/新的依赖项提议
安全性 - Windows/文本风险已处理或不相关
已验证 - 命令/结果或理由
风险 - 剩余限制(如果有)

对于 audit 模式,首先返回发现,尽可能附带文件/行引用,然后是一个删除/重用列表以及最小的验证差距。

相关技能