用途:在任务完成后,把实现内容记录为跟踪器工作项上的结构化评论,作为“已存在什么”的权威知识库,供未来工程师和 AI 智能体在写新代码前检索。该技能由执行器(task-executor / sprint-executor / epic-executor)每个完成任务调用一次,也可直接调用以补录日志。
主要能力:技能与跟踪器无关,所有读写通过抽象操作完成,具体调用位于适配器文件;仅需 getWorkItem(id)(确认条目存在)、comment(id, body)(发布渲染后的日志)、addLabel(id, label)(打上 impl-logged 标签)。支持 jira、linear、ado、local 四种跟踪器,适配器文件位于 skills/task-executor/references/ 下对应 md 文件。产物 schema 借鉴 spec-workflow-mcp,包含可选的 apiEndpoints、components、functions、classes、integrations、dataModels、pipelineStages 等类别。
使用方式:输入包括工作项 id、跟踪器类型、摘要、创建/修改的文件列表、统计(来自 git diff --shortstat 的 linesAdded、linesRemoved)、产物结构化数据、提交哈希;可选 docs 后端用于镜像。流程:校验输入(确认条目存在、至少一个产物类别、文件列表非空,输入过薄则先索取细节);按模板渲染日志(Linear 评论为字面 markdown,真实换行,不转义 \n);发布评论;打 impl-logged 标签(各跟踪器的标签合并语义由适配器处理);tracker: local 额外将日志镜像到 documentation/impl-logs/{id}.md;若配置 docs 后端则通过 publishRecord 镜像到对应文档面。返回评论 URL/id、标签确认及镜像路径。
适用场景:任务、冲刺或史诗完成后自动记录实现;补录已关闭但从未记录的工作项(读取描述与提交,用 git log --follow、git show 推断文件与统计,从 diff 推断产物,先给用户确认再发布)。
限制与最低质量要求:创建 API 端点、UI 组件或类时对应产物字段必须填写;纯重构可空产物但摘要须注明“仅重构——无新公开接口”。不评估代码质量、不改变或关闭工作项状态、不添加提交或运行测试;除本地跟踪器镜像外不写仓库文件。若文档面不存在,应告知调用者创建,而非静默跳过。