用途:在开发任务过程中记录智能体开发者体验(agentic DX)摩擦。资料强调,阻塞智能体的摩擦往往也暴露开发者的 DX 问题,因此摩擦记录应与任务完成同等重要。
主要能力:确定输出文件(有参数用参数,否则以 fl-<feature>.md 命名;若创建了 fl-<feature>/ 文件夹,日志放在 fl-<feature>/fl-<feature>.md);从用户首条消息识别任务;记录输入(URL 或本地路径);逐字记录初始提示;记录模型与 harness;先读取提示中的 URL;新建仓库以 fl- 前缀命名;实时记录摩擦,每条说明预期、实际发生、尝试过什么、如何解决(或未解决);用来源标签([web search]、[docs]、[training data]、[sandbox])标注信息来源;每个摩擦点(🟡 或 🔴)必须产生至少一个具体行动项,分为 Docs、Framework、DX / Research 三类;构建失败按 🔴 记录并重试,最多三次;跟踪累计构建时间;工具超时按 🔴 记录且不重试同一命令;完成后写出日志并 cat 到 stdout。
使用方式:作为技能被调用时按上述流程执行,遵循 references/template.md 的输出格式、references/example.md 的示例、references/agent-behavior.md 的行为指引。日志可粘贴到 https://agent-friction-skill.vercel.app/ 查看可折叠、按严重程度编码的视图。
适用场景:开发流程中需要记录智能体卡点、暴露 DX 问题、为文档或框架改进提供依据时。
限制:运行中不主动向用户提问,除非真正被阻塞且 harness 支持交互;不得使用占位符;最终日志必须包含全部必需章节;Skill Feedback 仅在用户明确指出技能本身导致错误行为时追加,且不得留空。资料未提供安装命令、收费或价格信息。