SuperAPI AI 工具集

friction-log

编程与开发

查看项目

更新于 10-15 17:21

技能介绍

用途:在开发任务过程中记录智能体开发体验(agentic DX)摩擦。被调用时,先确定输出文件:有参数则用参数,否则以任务命名并加 fl- 前缀,如 fl-<feature>.md;若本次运行创建了 fl-<feature>/ 文件夹,日志放在该文件夹内。任务取自用户第一条消息,不先追问澄清。若涉及已有代码库,在日志头部记录 Input(用户给的 URL 或本地路径),并原样记录初始提示词。

主要能力:在日志顶部记录模型名与运行环境(harness);先读取提示词中的 URL 再开始任务;新建仓库以 fl- 前缀命名,避免 my-app 之类通用名;实时写入摩擦条目,每条说明期望、实际发生、尝试过什么、如何解决或未解决;每条日志末尾附来源标签(如 [web search]、[docs]、[training data]、[sandbox]);记录构建失败、工具超时等信号,构建失败按 🔴 记录并最多重试三次;若可计时,在头部累计记录 Build time。

使用方式:运行中不主动向用户提问,把不确定性作为摩擦写入日志并继续;若 harness 注入带外消息,指令类并入当前运行,提问类先简洁回复再继续,并用引用块原样记录。完成后写日志、cat 到标准输出,并停止;可提示日志可粘贴到 https://agent-friction-skill.vercel.app/ 查看。

限制:最终日志必须包含 Header、Prompt、Tool Timeline、Summary、Action Items(Docs + Framework + DX / Research)和 Log,不得留占位符;Skill Feedback 仅在用户明确指出技能本身导致错误行为时追加,不写空章节。上下文或步骤不足时,停止任务并立即写出完整日志。具体模板与示例见 references/template.md、references/example.md,行为指南见 references/agent-behavior.md。