关于 impl
impl 是一项指导按业务结果拆分实现并逐项提交的开发技能,适用于需要在既定项目规则内完成代码变更的工作。它强调加载相关上下文、最小化修改,并通过 atomic-commit 为每个交付单元创建本地提交。
主要功能
- 01按独立业务结果划分提交单元
- 02加载相关项目场景与规则
- 03映射需求到现有代码结构
- 04实施范围内的最小修改
- 05逐单元核对规则并本地提交
适用场景
- 01按完整业务能力拆分开发任务
- 02在编码前加载相关项目约定
- 03确保代码、测试和文档随业务单元交付
- 04为每个提交单元创建可回滚提交
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ zuozh11/ agent-skill-engineering --skill impl安装后在 Claude Code 中输入/impl确认已加载。
附带文件agents/openai.yamlISOLATION.md
详细介绍
来自项目 READMEImpl
根据需求自行分解提交单元,逐个做最小实现,然后调用 atomic-commit 提交。
-w 使用隔离 worktree,-a 使用子 Agent 或 workflow 编排,两者独立且可组合。用户明确要求 worktree 或子 Agent / workflow 时,分别按 -w、-a 执行。使用 -w 或 -a 时,实施前完整读取 ISOLATION.md。
流程
1. 加载项目上下文
按项目知识协议执行。过目 scope 返回的全部 sceneId 与 ruleName,加载与本轮实现相关的场景或原子 RULE。会话已有知识仅在覆盖本轮实现时复用,不够则补 load。知识不可用时继续并如实说明,且不得声称已遵守。
2. 分解提交单元
提交单元以可独立说明的业务意义为边界:完成后,用户、角色或系统获得一项完整能力,或者产生一个可观察的业务结果。从任务卡、PRD、API 清单或当前对话中识别这些结果;共同完成同一结果所需的代码、测试、配置、迁移和文档放在同一单元,不按文件、技术层、接口数量或改动类型拆分。
只有形成不同且各自完整的业务结果时才拆分。每个提交单元还需满足 atomic-commit 的交付完整性与直接回滚标准。
3. 实施并提交
逐个提交单元执行:
- 查看现有代码,将需求映射到实际结构。映射后尚未覆盖的相关场景或原子 RULE 补 load。
- 改动涉及模块职责、接口表面积、接缝、adapter、测试面或深浅程度时,读取
codebase-design,根据需求、真实代码和项目规则确定必要设计;存在影响显著的可行方案分歧时,调用ask-me与用户确认。 - 做范围内的最小修改,优先复用现有能力。不添加需求与规则之外的兜底或防御性设计。
- 提交前核对每条已加载 RULE:就本单元改动判定符合或不适用,违反先改到符合。核对在实现过程内完成,通过后调用
atomic-commit,以当前提交单元为交付单元完成一个本地提交。
代码事实证明方案不可行,或需要扩展范围、改变已收口方案时停止并报告。
评论
支持 Markdown