SuperAPI AI 工具集

write-issue

通用与其它

查看项目

更新于 10-15 23:45

技能介绍

用途:将当前对话上下文转化为 Beads 议题,或编辑已有议题,适用于用户想创建或更新 bug、feature、task、epic 的场景。

主要能力与原则:强调持久性优先于精确性,议题可能在待办中停留数天或数周,期间代码库会变化,因此描述应在文件重命名、移动或重构后仍保持有用。应描述接口、类型和行为契约,点名具体类型、函数签名或配置形状;不要引用文件路径和行号,也不要假设当前实现结构不变。应描述系统应做什么而非如何实现,让智能体自行探索代码库并做实现决策。

议题类型:epic 为跨多个用户故事或子系统的广泛变更;feature 为交付给用户的单个连贯垂直切片;task 为小而明确的工作单元;bug 为当前已损坏、需要修复的问题。

使用方式:先根据变更范围推断议题类型,再按模板撰写议题正文,然后发布到 Beads Issue Tracker。创建新议题命令:bd create --type=<type> --title="<issue-title>" --description="<multi-line-body>" --acceptance="<multi-line-acceptance-criteria>";更新已有议题命令:bd update <id> --title="<new-title>" --description="<new-body>"。接受的标志包括 --title(简洁描述性标题)、--description(详细描述)、--acceptance(可测试的验收标准列表)、--notes(实现说明,关闭议题时记录解决方式)。

模板结构:Current State 从用户视角描述当前状态或问题;Desired State 从用户视角描述期望状态或解决方案;User Stories 为长篇编号列表,格式为“As an , I want a , so that ”,应极其详尽并覆盖功能各个方面;Out of Scope 描述不在本 epic 范围内的事项;Further Notes 记录其他说明。

限制:资料未提供该技能的安装方式、收费、价格、平台或效果信息。