用途:在 Azure DevOps 工作项上记录任务实现成果,形成可被 ADO 工作项搜索或 WIQL 查询的结构化评论,作为"已实现内容"的知识库;工作流在 tracker 为 ado 时路由到此技能,每个完成任务调用一次,也可直接用于补录日志。选择工作项评论而非仓库文件,是因为仓库日志会衰减或与 git log 重复,而工作项评论已是工作记录系统,且天然关联描述、链接、状态、迭代等上下文。
主要能力与工作流:输入工作项 id、单行摘要、新建/修改文件列表、来自 git diff --shortstat 的增删行统计、结构化工件(apiEndpoints、components、functions、classes、integrations、dataModels、pipelineStages,均可选)、提交哈希,以及可选的 docs 后端(confluence、notion、ado-wiki、local)与 Impl Logs 页面/数据集 id。步骤依次为:用 wit_get_work_item 校验工作项存在、确认至少一类工件且文件列表非空,输入不足时先索要细节;按共享模板渲染评论;用 wit_add_work_item_comment 发布;用 wit_update_work_item 添加 impl-logged 标签;配置文档后端时经 publishRecord 镜像到对应文档表面(ado-wiki 追加到 Impl Logs 页表格行、notion 写入数据库行、confluence 追加到页面、local 追加到 documentation/impl-logs/{id}.md),镜像目标不存在时提示调用方创建而非静默跳过;最后返回评论 URL、标签确认与文档镜像 URL。
质量与限制:新建 API 端点必须填 apiEndpoints,新建 UI 组件必须填 components,新建类必须填 classes;纯重构可在摘要注明"仅重构,无新公开接口"。本技能不评估代码质量、不关闭工作项、不向仓库写日志、不添加提交或运行测试。补录时读取工作项描述与提交,用 git log --follow、git show 推断文件与统计,并从 diff 推断工件后先向用户确认再发布。