SuperAPI AI 工具集

issue-basics

通用与其它

查看项目

更新于 10-15 22:12

技能介绍

用途:通过 forge issue 系列命令对 Forge 内核中的议题进行日常增删改查与协作操作,内核是唯一事实来源,不应手工编辑议题存储。

主要能力:创建议题(forge issue create --title "…" --type <task|bug|epic|decision>);查看单个议题(forge issue show <id> [--json]);列表与过滤(forge issue list [--status … --type … --priority … --label …] [--json]);全文搜索(forge issue search "…" [--json]);待办统计(forge issue stats [--json]);认领与释放(forge issue claim <id> / forge issue release <id>);更新字段(forge issue update <id> [flags]);添加交接备注(forge issue comment <id> "…");关闭(forge issue close <id...> --reason "…");依赖管理(forge issue dep add|remove <id> <blocks-id>)。

使用方式:创建时可带 --title、--type、--priority(P0..P4,P0 最高)、--label(逗号分隔,重复不累加)、--body/--description、--assignee、--acceptance、--parent。状态取值 open、in_progress、review、done、cancelled,默认 open。成功返回 { ok, schema_version, command, data, next_commands },失败返回 { ok:false, error:{ message, exit_code } },须先确认 ok:true 再解析 data。

限制:--type 原样存储,非规范值不报错但无内核行为;epic 与 decision 被排除在可认领队列之外,但 claim 仍可能返回 ok:true。delete 为设计上不支持,内核为追加式/事件溯源;重开用 update --status open。修改共享工作前应先 claim 获取数据库强制租约,放弃时 release。