Agentic Coding

设置

如果~/agentic-coding/不存在或为空，则读取setup.md文件，提出一个简洁的启动问题，并确保任何持久化操作都需明确选择加入。

定位

此技能特意区别于agentic-engineering和vibe-coding：

• agentic-engineering侧重于多智能体操作模式和团队吞吐量。
• vibe-coding侧重于提示驱动的探索和快速想法交付。
• agentic-coding侧重于合约优先的实现、修复证明和可供审查者验收的交付。

使用时机

用户需要来自AI代理的、符合合并要求的代码，并设有明确的质量关卡。适用于生产功能、高风险重构、带有可复现故障的缺陷修复，以及以Xcode为中心的工作，例如Swift功能交付、iOS/macOS回归测试和发布分支热修复。

架构

内存存储于~/agentic-coding/目录下。具体设置请参见memory-template.md文件。

~/agentic-coding/
|- memory.md       # Persistent preferences and operating mode
|- contracts.md    # Accepted task contracts and non-goals
|- evidence.md     # Test evidence and verification snapshots
`- handoffs.md     # Delivery notes and rollback hints

快速参考

按需加载这些文件，以保持上下文聚焦并确保执行速度。

核心规则

1. 先锁定契约，再编写代码

从一份简洁的契约开始每项任务：

• 目标：用一句话描述确切成果
• 验收标准：能证明成功的检查项
• 非目标：必须保持原状的部分
• 约束条件：技术栈、代码风格、限制、截止时间

无契约，不编码。

2. 运行PACT循环

每次执行都遵循相同循环：

1. P问题界定：重述目标与假设
2. A验收设计：在修改前定义检查项
3. C变更集：生成最小可用差异集
4. T追踪测试：展示证据与残余风险

这项技能关乎执行纪律，而非头脑风暴。 在Xcode工作流中，开始编辑前需将验收标准绑定到具体目标、模拟器/设备和测试命令。

3. 保持差异精准

一个用户目标对应一个聚焦的变更集：

• 优先进行文件局部修改而非大规模重写
• 将行为变更与样式清理分开处理
• 避免在声明范围外产生隐藏副作用

若范围扩大，应拆分为第二个合约

4. 先证明故障再验证修复

针对缺陷和回归问题：

• 首先捕获故障条件（测试、日志或复现步骤）
• 应用最小化修复方案
• 重新执行相同检查以验证解决情况

严禁在缺少前后证据的情况下宣称问题已修复

5. 交付可交接级成果

每个周期结束时提供交付包：

• 变更内容及原因说明
• 涉及文件及影响范围
• 验证过程与结果
• 已知风险及回滚方案

若交接要求不明确，则任务尚未完成

6. 采用结构化备用方案进行升级

当两次尝试失败后受阻时：

• 立即停止编辑
• 陈述已尝试的内容
• 提出两个有依据的替代方案
• 请求附带权衡的决策

不要在循环中持续猜测

常见陷阱

• 未进行验收检查就开始实施 -> 导致无限迭代且完成状态不明确
• 要求代理进行完整重写 -> 产生杂乱的差异并导致可避免的回归问题
• 将功能开发与架构重构混在一起 -> 导致可审查性弱且难以回滚
• 未提供可复现的证据就报告成功 -> 导致对生产环境产生虚假信心
• 将AI输出视为最终稿 -> 将质量负担转移至代码审查环节

安全与隐私

离开您机器的数据：

• 此技能本身不会产生此类数据

本地保留的数据：

• 合同、证据记录和交接摘要保存在~/agentic-coding/ 目录中

此技能不会：

• 触发未声明的网络请求
• 访问其自身存储路径之外的文件
• 写入全局或平台内存存储
• 未经明确证据即自动批准有风险的代码

范围

此技能仅：

• 提升AI辅助编码的执行质量
• 强制执行契约驱动的实现与验证
• 为审查者生成清晰的交接包

此技能绝不：

• 替代高风险领域的安全审查
• 鼓励对生成代码的盲目信任
• 覆盖项目特定的贡献规则

相关技能

使用以下命令安装clawhub install <slug>如果用户确认：

• agentic-engineering- 多智能体协作与操作模式。
• coding- 跨技术栈与任务的通用编码支持。
• code- 广泛的代码编写与编辑辅助。
• copilot- 助手风格的IDE辅助模式。
• delegate- 向自主代理进行结构化任务委派。

Feedback

• 如有帮助：clawhub star agentic-coding
• 保持更新：clawhub sync