xgent-ai

@xgent-ai source repo

14 skills
0 followers
7 hours ago last updated

▌
Prd · xgent-ai bundle
以资深产品经理视角把一个想法/诉求梳理成可被 SPMS 生命周期管理的需求——项目级「概述/目标/非目标」+ 逐条 FR/NFR（含可断言的验收标准与测试用例种子），产出 PRD 文档并写入 SPMS，作为 dev-plan 的前置输入。凡用户要求「写 PRD / 写需求文档 / 梳理需求 / 拆需求 / 提需求 / 需求评审 / 把这个想法变成需求 / 录入需求」，或给出一段业务诉求并期望先把「做什么、为什么、怎样算做完」定清楚时，务必使用本 skill——即使用户没说「PRD」三个字。正文按终局全景写,分期交付建议只在末尾一次给出并逐条标明终验期,避免把阶段交付误记为整条需求已完成。Use whenever the user wants requirements written, clarified, decomposed, or filed into SPMS (FR/NFR) before any implementation planning happens; the body states the full target scope, and a final section proposes delivery phases carrying each requirement's final-acceptance phase.

0
installs
▌
Elintp · xgent-ai
把一个技术主题、或一份技术文档（PRD、开发计划、技术方案、评审纪要）讲成任何背景的读者都能看懂并复述出来的 HTML 文档——大图示、显眼的关键数字、带图例的图表、表头带释义的表格、尽量少的术语。凡用户输入 /elintp <主题或文档>，或要求「讲得通俗一点 / 把这份 PRD 讲成人话 / 写给业务同事看的说明 / 给不做研发的同事解释这个系统」时使用。Use when the user types /elintp <topic-or-document>, or asks for a plain-language explainer or restatement of a technical document aimed at readers outside the engineering team.

0
installs
▌
Dev Plan · xgent-ai bundle
基于用户需求、仓库规则和当前代码事实，撰写或评审可直接交给实现者执行并跨对话续做的开发计划、技术设计、立项方案与实施路线图；也用于按某份既有计划推进实施时的进度回写与跨对话续做。用户要求先规划后实施、写 PLAN/设计方案、评审既有开发计划，或按一份计划文件实施、续做、更新实施进度时使用；用户只要求直接实现且没有计划文件时不要使用。

0
installs
▌
Test Plan · xgent-ai bundle
由需求（PRD 正文 + 验收标准）成套产出测试用例草稿并写入 SPMS（TC-N，关联需求），覆盖正常路径/边界/权限/并发四类，逐条验收标准给出「标准 → 用例」映射,写入前先查重。凡用户要求「补测试用例 / 写测试用例 / 出测试计划 / 这条需求要怎么测 / 覆盖一下验收标准 / 测试用例够不够」时，务必使用本 skill——即使用户没说「用例」两个字。Use whenever the user wants test cases written, test coverage expanded, or a test plan derived from SPMS requirements and filed as TC-N via the PMS MCP tools.

0
installs
▌
Xgent Init · xgent-ai bundle
在一个 XGENT.ai Portal 出仓 App 自己的仓库里生成配套的 CLAUDE.md / PRODUCT.md / DESIGN.md —— 读 app.manifest.json 与代码事实、一次性把缺的问清楚、按模板填出可直接用的三份文档，不留任何待填占位，已存在的文件不覆盖。凡任务是「初始化/接入一个新的出仓 App 仓库」「给这个 App 仓补上 CLAUDE.md / PRODUCT.md / DESIGN.md」「补一份 impeccable 能读的设计文档」，或用户刚拿到一个空的/只有代码没有规范的 App 仓时使用；门户 monorepo 内的 App、非 XGENT 项目不用本 skill。Use in an external XGENT portal app's own repo to scaffold its CLAUDE.md / PRODUCT.md / DESIGN.md from the app manifest and repo facts — one round of questions, no leftover placeholders, never overwrites existing files.

0
installs
▌
Story Points · xgent-ai bundle
按客观因子表给需求/工单估故事点（斐波那契档位）——因子分四轴：功能点的业务领域、触及的技术栈层、改动的复杂程度、验收的复杂度，与代码库和技术栈无关；并经 SPMS 的 MCP 面完成「读现状 → 判定 → 写回 plannedPoints → 复核 Sprint 容量」的闭环。凡用户要求「估点 / 估算故事点 / 给这条需求打几分 / 给 Sprint 的规划项估点 / 排期前先估一轮 / 复核迭代容量」，或给出一条需求并期望得到一个可复现、有判定依据的点数时，务必使用本 skill——即使用户没说「故事点」三个字。Use whenever the user wants story-point estimation for SPMS requirements/issues, sprint capacity review, or writing planned points back through the PMS MCP tools.

0
installs
▌
Grafton View Dev · xgent-ai bundle
用 @xgent-ai/grafton 做 schema 驱动 UI 开发的工作流与速查。当需要：(1) 用 JSON schema 写/改一个 grafton view，(2) 写绑定表达式（@store:: / @view:: / @local:: / @action:: / @form::），(3) 写 zustood store（createStore / extendSelectors / extendActions / createApiStore 等）并在 schema 中读写，(4) 写列表模板、条件渲染、双向绑定、表单，(5) 写带 Component.grafton 元数据的自定义 widget，(6) 排查 grafton 渲染报错（hooks 顺序崩溃、bindable 组件点不动、Fragment className、$type 解析失败）时，使用此 Skill。凡是涉及 createView / grafton schema / @store:: 表达式 / grafton widget 的活，都先用它，别凭记忆硬写。注意：配置 grafton-app.json 用 web-app-dev，创建模块脚手架用 web-module-dev。

0
installs
▌
Portal Dev Setup · xgent-ai bundle
在你自己 App 的 repo 里，用 Docker 起一个真实的 XGENT.ai 门户（一盒 / one-box）做本地联调——不 clone 门户、不改门户代码、不重建门户镜像。一条 onebox.sh init 检查本地 puller 凭证（.xgent-registry.env 里的 REGISTRY + PULLER_AUTH，缺了就停下来让用户先去开发团队要）→ 自动 docker login 并拉门户镜像 → 从镜像里取出 compose 资产、挑空闲端口、生成 compose.env；再一条 onebox.sh up 按固定顺序 migrate → seed → register-app → 起栈并自动体检；跑不通先 onebox.sh doctor（把排查表能自动判的都判一遍并给出可粘的修法），要拉别的 App 陪调用 onebox.sh add <key>。凡任务涉及「首次把我的 App 接到门户上调试 / 起一盒 / 起本地门户 / 拉门户镜像 / 本地跑不通门户联调 / 一盒重置」，或出现前端产物目录 /srv/www/apps 不可写、EACCES、duplicate input 导致反代全站 502、拉不到门户镜像、unauthorized、denied、/svc/<key> 404 或 502、localhost 打不开、port is already allocated、COMPOSE_PROJECT_NAME 撞栈把别的容器接管了、portal-api 一直 unhealthy、register-app 报 VALIDATION_FAILED、自省 401、有效 TDT 被判 INVALID_TOKEN、iframe 白屏、跨应用交换在发起方 401 这类症状时，务必先用本 skill 再敲 docker compose——即使用户只说「把门户跑起来」。Use when an external App team brings up, smoke-tests, resets, or debugs a real XGENT portal locally (the one-box Docker stack) from their own repo, without the portal monorepo.

0
installs
▌
Portal Micro App · xgent-ai bundle
开发/修改 XGENT Portal 的嵌入式微应用前端（micro 型 App，iframe + @xgent/portal-sdk，即 apps/*-app）。凡任务涉及新建一个 App 前端、给某 App 加页面/导航项/Dashboard Widget、SDK 握手/getToken/callService、consent 授权屏、或 iframe 内的 UI 异常（弹窗无效/菜单点不动/主题/路由同步/全屏/剪贴板）时，务必先用本 skill——即使用户没提"微应用"三个字。Use when building or changing any micro-app frontend embedded in the portal (apps/*-app), the portal SDK handshake, navItems, dashboard widgets, or iframe-specific UI issues.

0
installs
▌
Xgent Image Push · xgent-ai bundle
把 App 镜像构建并推送到自建的私有 Harbor 镜像仓库（地址由本地配置提供，不写在这个 skill 里）。用户提到发版、上线新版本、发布镜像、推镜像、docker push、打 tag 推仓库、配 CI 的镜像构建推送步骤、私有镜像仓库、Harbor、robot 账号推不上去、push 卡住推不动、ImagePullBackOff 之前的推送环节，都用这个 skill —— 哪怕他们只说"发个版"或"把这个服务的镜像推上去"没提仓库名字。它在推之前自动预检四条会让流水线静默失败的硬约束（链路、镜像架构、tag 不可变、保留策略），绕过它直接 docker push 很容易踩中其中一条。

0
installs
▌
Xgent App Release · xgent-ai bundle
把一个 App 的新版本发布到 XGENT.ai Portal —— 在 App 自己的 repo 里用 xrel_ 发布令牌一条命令提交「前端产物 dist / bump 版本 / 换镜像 / 整份 app.manifest 清单」，落成发布提案：无治理变更自动生效，改权限面的进平台「发布审核」等批准；不登录门户控制台、不找门户运维代传。凡任务涉及发版/发布前端或后端镜像/上传产物/提交或修改 app.manifest.json/首次把 App 接入门户/release-cli/xrel_ 令牌/POST /api/market/release/、配 vite base、在 CI 里写发布步骤、或出现「发布 401 / 404」「发布 200 但 ok:false」「PROPOSAL_PENDING / 一直 pending 等审」「/apps/<key>/ 白屏或资源 404」「发上去了但线上没变 / 容器没换版」这类症状时，务必先用本 skill 再动手——即使用户只说「发个版」。Use whenever publishing or debugging an XGENT portal app release from the app's own repo — frontend dist, backend image, or manifest/governance changes via release proposals: release tokens, packaging, version bumps, CI wiring, pending approvals, or a blank/404 /apps/<key>/ page after a publish.

0
installs
▌
Portal Backend App · xgent-ai bundle
在本 monorepo 内新增或修改「独立后端 App」（apps/*-server + apps/*-app 双包模式，如 spms/qbank/lms/llm-gateway/exam/library）。凡任务涉及新建一个后端服务、TDT 自省/四道闸/服务账号、App 的 scope 与 ACL 声明、LISTING_DEFS/seed 布线、给某 *-server 加 API 端点、DB 迁移或字典表、应用配置 tab、部署接线（Caddy/compose/DEPLOYABLE_APP_SERVICES）时，务必先用本 skill——即使用户只说"给 XX 应用加个接口"。Use when creating or extending a standalone-backend app inside this monorepo: gate/introspection, service accounts, listing/seed wiring, migrations, admin config tabs, deploy wiring.

0
installs
▌
Portal App Exchange · xgent-ai bundle
跨应用调用（OAuth Token Exchange）的布线与排错。凡任务涉及让 App A 读 App B 的数据（如组卷读题库、文件调多模态解析、任务中心读 LMS）、声明 exchangeTargets/交换白名单/consent 共授，或出现 EXCHANGE_NOT_ALLOWED / EXCHANGE_CONSENT_REQUIRED / CONSENT_REQUIRED / SECRET_INVALID / GRANT_NOT_ALLOWED / 跨应用下拉列表莫名为空等症状时，务必先用本 skill 再动手改代码。Use for wiring or debugging cross-app token exchange: grants, whitelists, consent co-grant, scope intersection, and the classic failure modes (secret drift, missing user consent rows, consent narrowing).

0
installs
▌
Portal External App · xgent-ai bundle
接入「外部镜像服务类应用」——服务端代码不在本 repo、以 Docker 镜像交付的 App（知识库/多模态解析/异步任务网关这类）。凡任务涉及为外部服务写对接契约或 app.manifest.json、register-app/provisioning 注册布线、/svc 路由与健康检查、外部服务的服务账号与 scope、一盒(one-box)本地联调、或评审外部团队的交付物时，务必先用本 skill——即使用户只说"把 XX 服务接进来"。Use when integrating an externally-built docker-delivered service app into the portal: manifest, register-app, provisioning, /svc wiring, one-box debugging, or reviewing an external team's delivery.

0
installs

14 published skills