核心用法
meegle-api 是 Meegle 项目管理平台的 OpenAPI 技能索引,采用模块化分层设计,强制按顺序读取子技能:
1. meegle-api-users — 必须先读取,获取 domain、access_token、project_key、user_key 等全局上下文与请求头规范
2. meegle-api-space — 空间(项目)级操作
3. meegle-api-work-items — 工作项(任务/需求/缺陷)的增删改查
4. meegle-api-setting — 字段类型、流程配置等设置项
5. meegle-api-comments — 评论系统 API
6. meegle-api-views-measurement — 看板、甘特图、图表与度量数据
所有子技能物理路径位于 skills/meegle-api/meegle-api-*/SKILL.md,需显式使用 Read 工具按需加载。
显著优点
- 清晰的依赖顺序:强制 users → 业务模块的调用链,避免认证上下文缺失导致的 401/403 错误
- 模块化隔离:按功能领域拆分,减少单次读取的 token 消耗与认知负担
- 企业级覆盖:完整覆盖项目管理的全生命周期(空间→工作项→配置→协作→度量)
潜在缺点与局限性
- 强制多步骤:无法单轮完成跨模块操作,至少需要 2 次读取(users + 目标模块)
- 无动态发现:子技能列表为静态表格,新增模块需人工更新索引
- 企业级锁定:与 Meegle 平台深度绑定,无法迁移至其他项目管理工具
适合人群
- 企业开发者:需集成 Meegle 到内部系统的后端工程师
- 自动化运维:构建 CI/CD 流水线与项目数据同步的 DevOps 团队
- BI 分析师:提取度量数据用于自定义报表的场景
常规风险
| 风险类型 | 说明 |
|---------|------|
| Token 泄露 | access_token 需妥善保管,避免硬编码到客户端 |
| 权限越界 | project_key 与 user_key 需校验作用域,防止跨项目访问 |
| 调用顺序错误 | 未读取 users 直接调用业务 API 将导致认证失败 |