用途：friction-log 用于把仓库或软件包中持续存在、反复出现的摩擦记录成可长期跟踪的 friction issue。它强调问题应有明确负责人和可复现的契约缺口，例如缺少步骤、类型声明与实际不符、测试框架损坏、文档与代码不一致、测试脆弱等。只记录下次智能体无需当前会话上下文就能处理的问题；一次性困惑和仅限当前会话的小问题不应归档。
主要能力：可记录问题发生情况、期望结果、复现方式、成本、已调查内容和相关文件；归档前先搜索已有未关闭的 friction issue，若匹配则直接评论复用；每个 issue 可标注优先级，并在需要人工决策时使用项目分诊方案中的决策标记（如 autopilot rung 11、默认 P0–P3 标签加 needs-decision）；friction-skipped 标签可标记该 issue 在后续摩擦扫描中暂时跳过，直到有人移除标签。若当前变更范围内有明显低风险摩擦，可顺手修复并说明，剩余部分再归档。
使用方式：在 Kody 环境下，通过 @kentcdodds/friction-log 调用，使用 prefer-local-kody-execute，传入必填的 target 和 items（单元素数组也可）。target 为 { host: 'github', repo: 'owner/repo' } 时在对应仓库打开或复用 friction issue；为 { host: 'kody', repo: '@owner/leaf' } 时路由到对应 Kody 包的所有者。命令示例：npx @kodycodes/cli execute --local --code 'import run from "kody:@kentcdodds/friction-log/file"; export default (p) => run(p)' --params '{"target":{"host":"github","repo":"owner/repo"},"items":[{"title":"…","whatHappened":"…","whatYouWanted":"…","howToReproduce":"…","cost":"…","preliminaryInvestigation":"…","relevantFiles":["…"]}]}'。执行结果会归入 filed、reused、woke 或 skipped；skipped 表示未达到归档标准，应保持未归档。随后为每个已归档 issue 添加优先级。不使用 Kody 时，可用仓库的 friction 表单或问题追踪器的等效方式创建 issue，并带上 friction 标签和优先级。
适用场景：适合开发会话中遇到明显但不属于 ship-pr 遗留处理流程的摩擦时归档；适合需要跨会话传递、希望下次智能体能直接跟进的仓库或包级问题；也适合需要统一收集复现步骤、成本与调查线索的维护流程。
限制：仅记录达到标准的问题，一次性困惑和会话内小问题不应归档；不得包含机密和隐私数据；目标仓库或 Kody 包的路由需按指定格式提供；优先级和决策标记需遵循项目自身分诊方案；未提供 Kody 时需依赖仓库表单或追踪器等效流程。