SuperAPI AI 工具集

create-issue-interaction-ui

写作与研究

查看项目

更新于 10-16 03:15

技能介绍

用途:这是面向 Paperclip 仓库贡献者的开发者/维护者技能,用于在 paperclipai/paperclip 中端到端引入新的 issue-thread 交互类型(如紧凑选择器、结构化评分、线程内审批卡)。不适用于生产 Paperclip 智能体,也不用于给现有交互类型加字段、修改智能体调用方式或构建非线程 UI。

主要能力:按四层推进——共享契约(kind 常量、payload/result 接口、Zod 校验器、导出与共享测试)、服务端(创建/接受/拒绝/响应、过期、取代、幂等、活动日志、唤醒)、UI(卡片待处理/已解决/过期状态、fixtures、Storybook、IssueDetail 接线)、辅助与文档(CLI、MCP 工具、插件 SDK 类型与测试、skills/paperclip 指南)。现有四种类型可作范本:request_confirmation、request_checkbox_confirmation、ask_user_questions、suggest_tasks。

使用方式:先做共享契约,再依次做服务端、UI、CLI/MCP/插件 SDK、智能体指南。参考已合并的 checkbox 确认示例:git show --stat 4d5322c82。提交前运行聚焦测试:NODE_ENV=test pnpm run preflight:workspace-links 与 NODE_ENV=test pnpm exec vitest run 指定测试文件;若 UI 报 act is not a function,需显式设置 NODE_ENV=test。

限制与不变量:仅看板可解决,智能体发起的接受/拒绝应走 403;所有读写、过期、取代须按 companyId 过滤;目标绑定复用共享 RequestConfirmationTarget;默认 supersedeOnUserComment: true;幂等键形如 <kind>:<issueId>:<decisionKey>:<revisionId>;选项数量有上限、id 唯一、标签与描述长度受限;已解决的大选择集先按数量汇总。避免复用其他类型的字段名、另写过期/取代逻辑、跳过插件 SDK/MCP/CLI 覆盖,或在服务端路由支持前先写智能体指南。具体价格、平台等信息暂未提供。