SuperAPI AI 工具集

task-creation

办公与效率

查看项目

更新于 10-16 08:49

技能介绍

用途:在问题跟踪器中撰写和审核工作项(缺陷、变更、调查),让接手的人或智能体能直接开始工作。

主要能力与要点:

  • 先确定读者。人类实现者是默认读者;仅有明确信号(显式指派给编码智能体、任务拆分中的 AFK 分类、由智能体处理的任务队列)时才选智能体读者。两种读者只影响篇幅,不影响真实性。
  • 写前先验证。缺陷需实际运行失败路径;不得编造截图、错误文本、版本号或文件;声称原因前先读代码,未确认的根因写成假设或省略;粘贴原始产物而非转述;未验证的内容在项内标注。
  • 类型取自契约而非症状:判断行为是否违反文档、测试或 API 保证,而非仅令人失望。搜索既有项(症状与确切错误串)后即可停止,重复检查不是门槛。
  • 给出位置:仓库当前存在的文件、模块、符号或失败测试,只列 HEAD 上存在的内容;不粘贴周边代码;不确定确切文件时给出模块、符号或入口点;长期排队项可加不随重命名失效的锚点。
  • 验收标准写进项内,每条由观察判定,命名命令、测试或输出;并列出不得改变的行为与约束。格式按跟踪器既有约定,无约定则用清单。
  • 内容按工作类型匹配:缺陷(观察行为、期望行为及其依据、实际运行的复现、环境与版本、产物);变更(问题与目标、位置、验收标准、约束);调查(观察、待答问题、答案形式)。
  • 省略读者已有内容:仓库约定放 AGENTS.md、CLAUDE.md;不粘贴对话,改为提炼意图并链接;不改写可链接的文档。
  • 字段与链接按跟踪器设置,只设项目实际使用的字段;路由字段(组件、区域、负责人)同样谨慎;使用原生链接而非在文本中写 ID。
  • 创建前必须展示完整草稿并取得明确批准,任何修改后重新展示;批量按整体审批。创建后报告 ID、URL 及工具无法完成的部分。

限制:标题与描述格式、元素顺序等属本技能约定,无测量依据;INVEST 与质量清单不构成证据,清单只能检查结构,无法判断内容真伪。若跟踪器既有项与本约定冲突,遵循跟踪器并说明一次。