数创研发
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_56b46fc7/sk4526664774。
技能介绍
要解决什么问题
在数创/P50 相关项目里,工程师经常要在换机器、没装 MCP、没有 api-doc-server 的环境里查 OpenAPI、改账号、填周报或动项目/需求数据。若工作流绑在本地服务和 MCP 上,路径一硬编码就失效,项目编号也常只记得 P48 这类简称,和系统里的 P048-B01 对不上。
技能如何工作
本技能把日常操作收成 Work Skill:脚本路径一律用 SKILL_DIR,由 WorkBuddy 注入技能目录,避免写死用户路径。
- 接口文档:
scripts/query_api.py,默认--direct直连上游 OpenAPI;可列项目、列接口、查详情,并按接口summary导出为独立.md(含方法、路径、参数、请求体与响应结构)。download仅支持直连模式。 - 业务操作:
scripts/p50_api.py直连后端 API,覆盖账号、周报、项目、需求等场景,不依赖 P50 MCP Server。 - 查询习惯:用具体功能名(如「批量下载二维码」),不要用模块标签(如「人员二维码发放管理」)。
- 项目编号:先
projects list做模糊匹配——0 个提示不存在,1 个自动选用,2 个及以上必须让用户选;禁止未经确认直接建新项目。 - 每步操作完成后用 3~5 行向用户汇报结果。
项目与上游地址在 projects.json 中维护(例如 P51 含 busi/system/file 等多文档源)。
边界与注意
需要内网能访问文档源与 .env 里配置的 P50_API_BASE_URL 对应后端;多模块命中接口时用 --tag 收窄。技能刻意不引入 Flask、本地文档服务或 MCP 配置,适合「只带技能目录 + Python 3」的便携用法。
使用场景
- 在未安装 api-doc-server 的电脑上,需用 `--direct` 列出项目并查询「分页查询发放台账」等具体接口的路径、参数与响应结构。
- 对接评审前,要把某项目指定模块下的接口按 `summary` 批量下载为独立 `.md`,便于逐条对照方法、请求体与返回字段。
- 本机没有 P50 MCP Server 时,仍需直连后端完成账号相关操作或提交、查询周报内容。
- 业务方只说「P48」等不完整项目编号时,先执行项目列表做模糊匹配,确认唯一项目后再关联或维护需求,避免直接新建项目。
适合人员
- 对接 P51 会议、场地或人员二维码等 busi/system 接口的后端开发,需要在临时环境直连 OpenAPI 而非本地文档服务。
- 维护 P50 项目与需求数据的产品或研发同事,经常收到不完整项目编号,必须先匹配系统内正式项目再改数据。
- 编写接口级测试用例的测试工程师,希望按接口功能名检索并把详情导出为结构化 Markdown 做用例设计。
- 在多台电脑间只复制 `~/.workbuddy/skills/work/` 目录、不愿部署 MCP 与 Flask 的内网研发成员。