@huangqz/tapd-cli

@huangqz/tapd-cli

通过本地 Markdown 文件管理 TAPD 需求的命令行工具。

安装

npm install -g @huangqz/tapd-cli

快速开始

1. 认证

# 使用个人令牌认证
tapd auth bind --mode personal --token YOUR_TOKEN --workspace-id YOUR_WORKSPACE_ID

# 或使用开放应用凭证认证
tapd auth bind --mode app --client-id YOUR_CLIENT_ID --client-secret YOUR_CLIENT_SECRET

2. 初始化项目

tapd init

3. 创建需求

创建一个 Markdown 文件，例如 需求.md：

---
workspace_id: '58491787'
iteration_id: '1158491787001000001'
---

# 需求标题

需求描述内容...

## 功能点

- 功能 1
- 功能 2

然后执行：

tapd story create ./需求.md

4. 更新需求

修改 Markdown 文件后：

tapd story update ./需求.md

主要功能

• ✅ 支持 Markdown 格式编写需求
• ✅ 自动转换 Markdown 为 TAPD HTML 格式
• ✅ 支持 Mermaid 图表（自动渲染为图片）
• ✅ 支持本地图片上传
• ✅ 双向同步：从 TAPD 拉取需求到本地
• ✅ 评论管理

命令列表

认证相关

• tapd auth bind - 绑定 TAPD 凭证
• tapd auth status - 查看认证状态

工作空间

• tapd init - 初始化项目配置
• tapd workspace list - 列出所有工作空间
• tapd workspace use - 切换默认工作空间

需求管理

• tapd story create <file> - 从 Markdown 创建需求
• tapd story update <file> - 更新需求
• tapd story get <story-id> - 拉取需求到本地
• tapd story list - 列出需求

评论

• tapd comment add <file> - 添加评论
• tapd comment list <file> - 查看评论列表

Markdown Frontmatter 字段

---
tapd_id: '1158491787001631079'           # TAPD 需求 ID（更新时必需）
workspace_id: '58491787'                 # 工作空间 ID
iteration_id: '1158491787001000001'      # 迭代 ID
creator: 'username'                       # 创建人
owner: 'username'                         # 处理人
label: 'feature'                          # 标签
status: 'developing'                      # 状态
---

许可证

MIT

问题反馈

https://github.com/qizhi2design-svg/tapd-cli/issues