SuperAPI AI 工具集

local-impl-logger

编程与开发

查看项目

更新于 10-16 02:39

技能介绍

用途:在 tracker 配置为 local(无 JIRA/Linear MCP)时,记录某任务“实现了什么”,作为“已存在内容”的可检索知识库,供后续工程师和 AI 代理在写新代码前先 grep documentation/。它是 jira-impl-logger / linear-impl-logger 的离线并行版本,由 task-executor / sprint-executor 经适配器的 implLogger 路由调用,每个完成任务调用一次,也可直接用于回填日志。

输入:item id(如 LOC-102)、一行 summary、Files created/Modified 路径列表、统计(linesAdded / linesRemoved,来自 git diff --shortstat)、artifacts 结构化数据、commit hash;可选 docs backend(docs: confluence | notion | local)。artifact 类型(apiEndpoints、components、functions、classes、integrations、dataModels、pipelineStages)均可选,schema 见 prompts/coding/templates/impl-log-artifact-schema.md。

主要流程:1) 校验输入,确认 documentation/tracker/{id}.md 存在、至少有一个 artifact 类别、文件列表非空,否则向调用方追问;2) 按 jira-impl-log-template.md 渲染日志,含 Summary、Commit、Files(Created/Modified/Stats)、Artifacts 各表、Searchable Keywords;3) 把日志追加到工作项文件的 ## Activity Log(不存在则创建);4) 写入 documentation/impl-logs/{id}.md 并加回链,目录不存在则创建;5) 通过本地适配器 addLabel 打上 impl-logged 标签;6) docs 为远程后端时经 docs adapter 发布(docs: local 则不重复);7) 返回更新后的工作项文件路径与锚点、镜像文件路径、标签确认。

限制与边界:不评估代码质量、不改工作项状态、不调用任何 MCP、不提交 commit、不跑测试。质量底线:创建 API 端点须填 apiEndpoints,创建 UI 组件须填 components,创建类须填 classes;纯重构可空 artifacts 但须在 summary 说明“Refactor only — no new public surface”。回填旧条目时读取描述与相关提交,用 git log --follow / git show 识别文件与统计,并从 diff 推断 artifact,写入前交用户确认。费用、平台、版本等资料未提供。