SuperAPI AI 工具集

work-item

办公与效率

查看项目

更新于 11-04 19:59

技能介绍

work-item 是面向项目管理的技能,主要用于在规划前对任务类产物进行梳理、拆分、评审和就绪检查。调用方式为 $work-item,原名 /pbi 已不再作为斜杠命令解析,模式划分保持不变,原先以 --type=pbi 指定的类型现改为 --type=task。

用途与模式 它一次只运行一个由参数显式选定的模式,必须在任何工作开始前检测 --mode=,不允许根据产物、其他参数或对话内容推断模式。未提供模式或模式值未知时,只打印模式分派表并停止,不做提问、不猜测、不执行。可用模式包括:--mode=refine 用于计划梳理,把计划拆成任务、验证问题假设、执行访谈、编写验收标准与估算;--mode=story 用于从任务切分用户故事,把功能拆解为符合 INVEST 的故事;--mode=mockup 用于根据任务、故事或规格产物生成交互式 HTML 原型,--explore 可在范围门禁后提供 1 至 3 个设计方向;--mode=challenge 用于由不同评审者对任务草稿进行 AI 辅助质疑;--mode=review 用于交接前的产物质量审查,支持 task、story、spec-tests、design 等类型,包含按类型检查清单、M1-M7 门禁和经校验的修复循环;--mode=dor 用于规划前对任务及其故事进行就绪检查,包含 8 项 DoR 标准、故事行和 M1-M7 门禁。这些模式分别对应此前的 /refine、/story、/pbi-mockup、/pbi-challenge、/artifact-review 和 /dor-gate。

使用方式 使用时应先选择模式,再完整读取该模式对应的参考文件,其中包含该次调用的全部规则、门禁、参数、报告路径、轮次上限与提醒;随后解析项目根目录并执行该模式的流程,最后校验输出与完成门禁,把后续步骤交给用户选择。各模式专属参数(如 --type、--reuse、--explore、--source)只在所属模式内生效,其他模式的参数忽略。用户在代码环境中共享技能时,需加载已注册的 .agents/skills/<name>/SKILL.md 并用相应工具执行,无需单独的技能工具或模式切换。

复用约定 review 模式的 --type=task 是评审结论的生产者,challenge 与 dor 是消费者。复用需通过 SHA-256 校验任务文件字节身份,报告头记录任务路径与摘要,文件大小和修改时间不作为身份依据;身份不匹配、摘要不可读或报告无法解析时,整个运行对该任务关闭复用。只有覆盖表列出的条目可从报告中引用,消费者自有检查始终需要重新评估,且复用的 FAIL 结论保持 FAIL。

限制 资料未提供该技能的收费、价格、平台兼容范围、性能效果或具体安装命令等信息。review 默认修复循环上限为 3 轮,扩展轮次需要询问用户;只读审查不产出修改;未跟踪的工作可继续执行,但须披露部分或不可用的顾虑。诊断性意见不代表就绪或验收通过。