SuperAPI AI 工具集

console-feature

通用与其它

查看项目

更新于 10-16 07:18

技能介绍

用途:编排控制台(console)功能的 issue 驱动开发流程。规范文件为 apps/console/design/development-flow.md,需先阅读并遵循其中的规则与模板;本技能只负责排序步骤和设置检查点。

必要用法:所有 gh issue / gh pr 命令必须带 --repo wso2/labs-agentic-engineer,issue 与 PR 只在上游仓库,不放在 fork 中;需要 gh auth。已关闭的 issue 和已合并的 PR 属于冻结历史,不得编辑或推送;ADRs 是当前事实来源。packages/contracts/api/v1/openapi.yaml 是 API 的唯一事实来源(issue #76),编辑即契约变更;用控制台范围的生成命令 pnpm --filter @aep/console gen,而非根目录 make gen。

检查点分三类:硬等待(issue 草稿确认、所有质询问题,超时则重新提问并等待,绝不代答);自动继续(记录类阶段:决策评论、ADR 毕业、握手 issue、PRD 进行中,仅转写用户已作出的决定);硬门(构建与发布,超时或非明确同意则干净停止并打印恢复命令)。

参数解析:纯数字(42、#42)或 issue URL 进入恢复模式;其他文本视为新功能想法;无参数则先询问功能内容。

新功能模式:收集上下文(读 apps/console/PRD.md 与 apps/console/design/decisions/ 中 ADR,检查 gh issue list --repo wso2/labs-agentic-engineer --label console --label feature,可加 --state closed 查历史);按规范模板起草 issue(Problem / Users / Experience walkthrough / Scope / Contract changes / States to design / Open questions),展示完整草稿并获明确同意后才创建:gh issue create --repo wso2/labs-agentic-engineer --label console --label feature。

恢复模式:gh issue view <n> --repo wso2/labs-agentic-engineer --comments;若已关闭则停止。查 PR:gh pr list --repo wso2/labs-agentic-engineer --search "<n>" --state all;已合并则冻结,新需求开新 issue;开启则进入构建阶段反馈循环;否则探测已完成阶段并从中断处继续。

阶段顺序:Grill(每问硬等待,可调用 grill-me 技能,否则自行按其实质访谈;开放期间用 gh issue edit 就地更新正文)→ 决策评论(自动继续)→ ADR 毕业(自动继续,仅满足跨功能约定、改 PRD 或否决可重提方案时才建 ADR)→ BE 握手(自动继续,仅当 Contract changes 非空,开单独 aep-api issue)→ PRD 进行中(自动继续)→ Build(硬门):契约 diff → pnpm --filter @aep/console gen → 覆盖决策场景的类型化 MSW mock → 用 VITE_API_MODE=mock 做 mock 模式 UI,UI 工作用 oxygen-ui 技能,遵循 apps/console/design/design-system.md 与 api-guidelines.md;推送功能分支并开 PR,截图本地保存后请用户拖入 PR,不得推送到 git 分支;在功能 issue 评论关联 PR 并引导反馈到 PR。反馈循环:每次推送前检查 gh pr view --json state,若已合并则不得推送。Ship(硬门,进入条件:BE 握手 issue 已同意并实现):验证方式由用户定义,需询问;将 PRD 进行中行移入功能清单、修正受影响章节并关闭 issue。限制:缺少资料的部分(如验证流程规范、具体平台或收费信息)暂未提供。