name: reflect-on-work description: 用于在完成工作后生成高质量反思的模式。所有智能体输出必须包含此模式。 allowed-tools: Read

工作反思技能

用于生成高质量反思的模式。

何时加载此技能

您正在完成任何任务
您需要生成必填的反思字段
您希望为系统演进做出贡献

必填输出字段

每个智能体输出必须以紧凑的JSON格式包含以下字段：

{"knowledge_updates":[{"category":"codebase","content":"您学到的内容","confidence":"certain"}],"reflection":{"what_worked":["字符串"],"what_failed":["字符串"],"patterns_noticed":["字符串"]}}

知识更新

类别

codebase: 发现的结构、组件、数据流
convention: 编码风格、模式、命名
decision: 设计选择及其原理
gotcha: 陷阱、变通方法、非显而易见的行为

置信度级别

certain: 已验证、已测试、有文档记录
likely: 有强证据但未验证
uncertain: 已观察到但需要确认

示例

{"knowledge_updates":[{"category":"convention","content":"项目在每个目录中使用桶式导出","confidence":"certain"},{"category":"gotcha","content":"使用AuthService前必须调用init()","confidence":"certain"},{"category":"codebase","content":"API路由遵循/api/v1/{资源}模式","confidence":"likely"}]}

反思字段

what_worked

成功的策略
有帮助的工具
值得重复使用的方法

what_failed

无效的策略
在错误方法上浪费的时间
遇到的问题

patterns_noticed

重复的序列（潜在的技能候选）
代码库中的常见模式
工作流程改进点

示例

{"reflection":{"what_worked":["并行探索器快速找到了上下文","从类型开始有助于构建代码结构"],"what_failed":["初始方法遗漏了边界情况","在探索前在错误的文件上花费了时间"],"patterns_noticed":["错误处理总是使用Result类型","测试文件与源文件放在一起"]}}

完整输出示例

包含反思的最小有效输出：

{"task_id":"task-001","status":"pre_complete","files_modified":[],"knowledge_updates":[],"reflection":{"what_worked":[],"what_failed":[],"patterns_noticed":[]}}

包含内容的完整输出：

{"task_id":"task-001","status":"pre_complete","files_modified":[{"path":"src/auth.ts","change_type":"modified","summary":"添加了登录函数"}],"knowledge_updates":[{"category":"convention","content":"认证使用JWT令牌","confidence":"certain"}],"reflection":{"what_worked":["快速找到了现有模式"],"what_failed":["初始测试方法是错误的"],"patterns_noticed":["所有服务都使用依赖注入"]}}

原则

诚实 - 报告失败，它们很有价值
具体 - 提供可操作的见解，而非模糊描述
简洁 - 简明扼要，无需详尽
使用紧凑的JSON - 单行，无格式