增量实现
用可验证的小步迭代安全交付多文件工程变更。
技能明确要求安全默认值、范围纪律和可回滚增量,未见恶意行为、凭证窃取或隐蔽外传;但要求逐步提交代码,未说明提交等外部副作用需用户确认,也未覆盖敏感数据、依赖安全和数据流披露,因此扣分。
流程结构自洽,包含实现、测试、验证和失败前停止等反馈机制;但测试命令、构建命令和引用的 git-workflow-and-versioning、definition-of-done.md 依赖项目环境,未提供异常输入处理或可复现运行证据,静态评估不超过10分。
目标受众和多文件、大规模或复杂变更场景清晰,也明确排除简单单文件函数修改;但触发边界仍较粗略,未说明不同语言、工具链、无测试项目、中文使用或受限网络环境下的适配方式,因此扣分。
文档采用概览、触发条件、循环、规则、清单和反合理化结构,README提供安装与仓库MIT许可信息;但选定技能没有独立版本、变更记录、维护责任或更新路径,且存在未随技能提供的引用依赖和环境假设,因此扣分。
薄切片、逐步验证、特性开关和可回滚建议能直接指导多文件工程变更,核心价值明确;但效果依赖代理实际执行测试、提交和项目命令,未有该技能关键路径的代表性输出或静态可验证结果,按静态上限保守扣分。
技能给出测试、构建、类型检查、Lint和提交等可审计检查项,仓库CI也验证技能结构与安装流程;但提供的CI和测试未覆盖该技能行为本身,缺少独立复现材料和第三方执行证据,因此仅给有限分。
- “Commit”被列为每个增量的必需步骤,但未定义用户确认、分支策略或提交失败时的安全处理;在自动化代理中应明确外部写操作边界。
- 测试、构建、类型检查和Lint命令是假设性的,项目可能没有对应脚本;技能应要求先探测可用命令并提供可诊断的缺失依赖反馈。
- 技能引用了其他技能和references文件,但本次证据未包含其内容,独立使用时可能出现上下文缺失。
- 未提供中文指令、语言无关示例或受限网络环境适配说明。
这个 Skill 能做什么,适合哪些场景?
该技能指导 AI 编程代理把涉及多个文件的功能、重构或较大改动拆成薄的垂直切片。每个切片都应完成一件逻辑上的事情,并保持项目可构建、可测试。流程要求实现、测试、验证、提交,再进入下一切片。它还强调范围控制、简单实现、功能开关、安全默认值和可回滚提交。
将多文件变更拆分为垂直切片、契约优先切片或风险优先切片;在每个切片后运行测试套件或补写测试,检查构建、类型检查、代码检查和功能结果;要求使用描述性 Git 提交保存进度;对未完成功能建议默认关闭的功能开关,并要求修改保持最小且便于回滚。
- 开发者实现跨数据库、API 和界面的新功能时,按端到端切片逐步交付。
- 团队进行前后端并行开发时,先定义接口契约,再分别实现和集成。
- 工程师进行重构时,希望每个小步都保持项目可编译且现有测试通过。
- 开发者面对 WebSocket 等高风险或不确定技术点时,先验证风险最高的部分。
- 任何即将一次性编写超过约 100 行代码的工程变更。
这个 Skill 有哪些优点和局限?
- 流程具体,明确规定每个切片的实现、测试、验证和提交步骤。
- 覆盖垂直切片、契约优先和风险优先三种拆分策略。
- 强调简单性、范围纪律、安全默认值和独立回滚。
- 提供功能开关、检查清单、常见借口和风险信号。
- 它是执行纪律和流程指导,不提供具体业务代码或自动化脚本。
- 要求测试、构建、类型检查、代码检查和提交,可能增加每个切片的操作成本。
- SKILL.md 没有提供特定项目的测试命令适配方案;示例命令假设项目使用 npm、TypeScript 和 lint 脚本。
- 来源没有提供该单独技能的测试结果或平台实测证据。
如何安装这个 Skill?
该技能属于 addyosmani/agent-skills 的 24 个技能集合。使用 Skills CLI 安装整个集合:npx skills add addyosmani/agent-skills。只安装本技能可使用:npx skills add addyosmani/agent-skills --skill incremental-implementation。README 未说明各平台单独安装该技能时的完整目录配置步骤。
如何使用这个 Skill?
在支持该技能的编码代理中,对多文件变更直接说明范围和切片,例如:Let's implement Task 3 incrementally. Start with just the database schema change and API endpoint. Don't touch the UI yet. After implementing, run npm test and npm run build. 也可在任务描述中明确要求每个切片完成实现、测试、验证和提交。
这个 Skill 与同类方案有什么区别?
README 指向与 Superpowers 及 Matt Pocock's skills 的比较文档,但提供的材料未给出这些替代方案与本技能的具体对比结论。