用途:在 Linear 任务完成后,把实现内容整理为结构化评论记录到对应 issue,形成可检索的"已有什么"知识库,供后续工程师和 AI 智能体在写新代码前检索,避免重复实现。由执行器每完成一个任务调用一次,也可手动回填日志。
主要能力:记录 issue id、单行摘要、新建与修改文件列表、增删行统计(来自 git diff --shortstat)、提交哈希、结构化构件(apiEndpoints、components、functions、classes、integrations、dataModels、pipelineStages,按任务实际情况选择性填充)及可搜索关键词;用 Markdown 渲染为评论后发布;给 issue 打 impl-logged 标签;在配置了 docs 后端时可选镜像到 Notion Impl Logs 数据库行或 Confluence Impl Logs 页面。
使用方式:先校验输入(确认 issue 存在、至少有一类构件、文件列表非空),再渲染评论并调用 save_comment({ issueId: "{issue-id}", body: "<rendered markdown>" }),捕获返回的 comment id。打标签时注意 Linear 的 save_issue.labels 为全量替换而非追加:需先 get_issue 读取现有标签,用 create_issue_label 创建 impl-logged(如不存在),再 save_issue({ id, labels: [...existingLabels, "impl-logged"] }) 传并集。若配置了 docs 后端,经 docs adapter 的 publishRecord 镜像;数据集不存在时应告知调用方先provision,而非静默跳过。
质量底线:若任务新建了 API 端点、UI 组件或类,对应构件必须填充;纯重构可留空但须在摘要中注明"Refactor only — no new public surface"。
适用场景:需要为 Linear 任务留存可检索实现记录、跨任务查询已发布端点/组件等构件。
限制:不评估代码质量、不改变 issue 状态、不写入仓库、不提交提交或运行测试;后续步骤与参数细节暂未提供。