核心用法
TAPD Skill 是一套完整的腾讯敏捷项目管理平台（TAPD）API 封装方案，覆盖从需求创建到发布计划的全流程操作。AI 可直接构造 HTTP 请求或使用附带的纯标准库 Python 脚本执行操作，无需 MCP 或第三方 HTTP 依赖。
主要能力矩阵：
- 需求管理：查询/创建/更新需求（stories）、获取字段配置与候选值、关联缺陷
- 任务追踪：任务 CRUD、状态流转（open/progressing/done 三种固定状态）
- 缺陷管理：缺陷查询/创建/更新、评论管理、图片与附件下载
- 迭代规划：迭代查询/创建/更新、发布计划（releases）获取
- 测试管理：测试用例查询、单条/批量创建（最多 200 条）
- 知识库：Wiki 查询/创建/更新，支持 Markdown 描述
- 工时统计：工时查询、新建与更新，支持按日期/人员筛选
- 工作流：获取状态映射、流转规则、结束状态、工作项类型
- 团队协作：企业微信机器人消息推送（需配置 BOT_URL）
认证方式：支持个人访问令牌（TAPD_ACCESS_TOKEN，推荐）或 Basic Auth（TAPD_API_USER + TAPD_API_PASSWORD）。所有请求需追加 ?s=mcp 标识，Header 需包含 Via: mcp。
显著优点
1. 零依赖设计：仅用 Python 3 标准库，无需 pip 安装任何包，部署环境要求极低
2. 双模式调用：既支持 AI 直接构造 HTTP 请求，也提供命令行脚本快速执行
3. ID 自动转换：内置短号转长号逻辑（云环境前缀 11，私有部署前缀 10），兼容不同部署形态
4. 完整链路覆盖：从需求创建→工时填报→缺陷关联→迭代规划→企业微信通知，形成 DevOps 闭环
5. 灵活扩展：通过 get/post 子命令可调用任何未封装的原生 API，保留 TAPD 全部能力
潜在缺点与局限性
- 字段配置前置依赖：使用 custom_field_* 查询前必须先调用 custom_fields_settings 获取配置，增加一次额外请求
- 富文本转换责任外移：测试用例的富文本需调用方自行转 HTML，本 Skill 不提供 markdown/html 转换
- 状态枚举非统一：任务仅有 3 种固定状态，而需求状态需通过项目配置动态获取，增加理解成本
- 企业微信独立配置：BOT_URL 需单独配置，与 TAPD 认证体系分离
- 批量限制：测试用例批量创建上限 200 条，大数据量需分页处理
适合人群
- 使用 TAPD 进行敏捷项目管理的研发团队
- 需要自动化需求/缺陷/工时数据同步的 CI/CD 流程
- 追求零依赖、轻量级部署的运维/开发团队
- 需要将 TAPD 数据与企业微信联动的协作场景
常规风险
- 令牌泄露风险：TAPD_ACCESS_TOKEN 或 API 密码以环境变量存储，需确保运行环境隔离，避免日志泄露
- 数据误操作：POST/PUT 操作直接作用于生产项目，建议先在测试项目验证
- ID 转换错误：跨环境（云/私有部署）时前缀规则混淆可能导致数据指向错误
- 速率限制：未明确说明 TAPD API 限流策略，高频调用需自行控制并发