chrisstarr7

Zentao Tools — Development skill for Claude Code

Development community

ZenTao tools Skill for Codex, Claude Code, and other MCP hosts.

How to install Zentao Tools

This entry records only its repository, not the path inside it, so there is no exact command to give. Open chrisstarr7/zentao-tools and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Zentao Tools does

ZenTao tools Skill for Codex, Claude Code, and other MCP hosts.

Alternatives in Development

Cyberboss — 一个接入微信的本地生活 Agent Bridge，让 Codex / Claude Code 拥有时间感、行踪感、随机唤醒和自主唤醒能力，用主动陪伴替代所有番茄钟和效率工具，自动记录日记、维护生活时间轴、发送文件和表情包 1.3k ★
Premiere Pro MCP — Adobe Premiere Pro MCP — independent, local-first server for supported workflows 292 ★
Tulpa — 基于Windows本地QQ+微信的Harness/MCP：用Agent进行实时检索、跟进、管理、记忆与工作区 179 ★

README

ZenTao Tools

为 Codex、Claude Code 等客户端提供 ZenTao MCP 认证和自然语言任务工作流的 Skill。它复用当前客户端已有的 ZenTao MCP，不是新的 MCP 服务。

功能

指导为支持动态 Header Helper 的 MCP 客户端配置认证续期。
指导 Codex 查询、匹配、创建和完成禅道任务，并避免重复写入或虚构工时。
提供可配置工作日历的预计开始/完成日期与按班次、休息时间倒推的工时区间计算。
在当前 MCP 缺少附件上传时，可用平台原生脚本将明确指定的需求文档上传到已创建任务。
提供 Codex 和 Claude Code 的 ZenTao API V2 登录示例。
使用 Windows DPAPI 或 macOS Keychain 保存登录密码，不把密码写入 MCP 配置。

任务匹配和写入取决于当前 MCP 实际暴露的工具与字段。若无法可靠确认当前账号、需求/执行或任务状态，Skill 会列出候选或停止写入；创建任务时必须提供预计工时，除非用户配置了默认值。

支持范围

客户端或服务	支持情况
Codex（Windows、macOS）	支持 ZenTao Header Helper 配置
Claude Code（Windows、macOS）	支持 ZenTao Header Helper 配置
OpenCode	当前配置示例不支持命令型 Header Helper
DeepSeek API	模型服务，不是 MCP 客户端；需通过支持 MCP 的客户端连接服务

ZenTao 示例使用固定的公司服务地址，不能直接用于其他 ZenTao 实例。其他 MCP 服务请先确认其认证方式、客户端重试行为和令牌签发规则，再按 Skill 指引配置。

环境要求

Windows 或 macOS
Node.js 18+、npm 和 Git
Windows PowerShell 5.1（Windows）
macOS 自带的 Keychain 与 security 命令（macOS；无需安装 PowerShell）
Codex 或 Claude Code
ZenTao 账号，并且该实例允许使用 API V2 登录

安装

npx -y skills add chrisstarr7/zentao-tools -g -a codex -y

macOS 和 Windows 使用同一条命令。它会将 Skill 安装到当前用户的 Codex；如需同时安装到 Claude Code，将 `-a codex` 改为 `-a codex claude-code`。安装后重启客户端或开启新会话。

Codex 会从用户级 Skill 目录自动发现本 Skill，相关任务会按需读取，不需要手动加载。ZenTao 连接仍需运行一次下面的配置脚本以安全保存账号凭据；安装过程不会自动读取或猜测账号密码。

从旧名称 `mcp-token-renewal` 或 `zentao-token-renewal` 升级时，请安装新名称后重新运行一次配置脚本，以更新客户端中的 helper 路径。已保存的 macOS Keychain 凭据会继续使用。

配置 ZenTao

运行对应平台的配置入口。

Windows：

powershell -NoProfile -ExecutionPolicy Bypass -File "$HOME/.agents/skills/zentao-tools/setup.ps1"

macOS：

node "$HOME/.agents/skills/zentao-tools/setup.mjs"

脚本会让你选择 Codex、Claude Code 或两者，检查客户端配置后，在本机提示输入禅道账号。Windows 使用隐藏密码提示并通过当前用户的 DPAPI 加密保存；macOS 使用系统 Keychain 密码提示保存密码，并由 Node.js helper 获取 token。写入前会备份已有配置；遇到不支持的配置格式或已有不同的 `zentao` 地址时会停止。

配置完成后重启所选客户端。不要在聊天中输入或发送账号密码。