coding-cli

coding-cli 是给 Wukong 团队成员和 AI Agent 使用的 CODING 任务命令行工具。

当前版本的目标很明确：

• 本地保存并验证 CODING token
• 在 yuncheng-group/nuohua 试点项目里执行任务 list / get / create / update / delete
• 给团队成员提供一套比网页更稳定、可重复的任务操作入口

如果本地文档和 wukong-ai-doc 冲突，以 wukong-ai-doc 为准。

事实源

• wukong-ai-doc/05-project-management/tasks/project-task-list.md（上游正式任务表，位于工作区文档仓）
• Wukong 对齐基线
• 当前状态

我该先看哪份文档

• 第一次接触 coding-cli：看 首次使用说明
• 已经拿到 token，只想安装和升级：看 安装与升级
• 遇到报错或命令没反应：看 常见问题排查
• 想知道内置任务模板怎么用：看 任务模板说明

如果你是第一次用 coding-cli，或者准备把它交给 AI Agent / skill 调用，建议先读 docs/first-run.md。

当前发布状态

团队正式发布口径是 npm registry，安装命令也已经固定下来：

npm install -g @qiean/coding-cli

但在 @yuncheng scope 发布权限完成前，团队内真实可执行的备用方式仍然是“源码安装 + npm link”。

所以请按下面规则理解：

• 如果公司已经通知“npm 包已发布”，直接走 安装与升级 里的 npm 安装
• 如果还没完成正式发包，先走下面的 Quickstart 本地安装

当前能力

• coding-cli auth login --token <token>
• coding-cli auth whoami
• coding-cli doctor
• coding-cli task meta fields
• coding-cli task meta statuses
• coding-cli task template list
• coding-cli task template show
• coding-cli task list
• coding-cli task get
• coding-cli task create
• coding-cli task update
• coding-cli task delete

Quickstart

如果 npm 包还没正式发布，下面这版 quickstart 可以直接从源码安装走到 task create：

# 1. 安装依赖
npm install

# 2. 构建 CLI
npm run build

# 3. 链接到全局命令
npm link

# 4. 登录本地 token
coding-cli auth login --token <your-coding-token>

# 5. 创建一条测试任务
coding-cli task create --project nuohua --title "Phase 1 smoke test" --description "created from coding-cli" --assignee-id <user-id>

说明：

• 这 5 步假设你已经手动在 CODING 网页里创建好了 personal access token。
• 如果你还没创建 token，先看 首次使用说明。
• 如果你要看正式团队安装、升级、回退口径，优先看 安装与升级。

常用命令

coding-cli doctor
coding-cli auth whoami
coding-cli task meta statuses --project nuohua
coding-cli task template list
coding-cli task template show --name bug
coding-cli task list --project nuohua
coding-cli task get --id 123
coding-cli task create --title "修复登录问题" --template bug
coding-cli task update --id 123 --status-id 9
coding-cli task delete --id 123

任务模板

模板来自 wukong-ai-doc/05-project-management/tasks/project-task-list.md 里的正式任务写法，先解决“创建 issue 内容要完整、不能空空荡荡”的问题。

当前内置模板：

• task
• requirement
• bug
• research

示例：

coding-cli task template list
coding-cli task template show --name requirement
coding-cli task create --title "梳理 CODING CLI 发布方案" --template task
coding-cli task create --title "登录页报错" --template bug

当前版本只会预填 description 模板骨架，不会自动写 CODING 的 项目分类、标签、严重程度 等自定义字段。详细说明见 任务模板说明。

本地开发

npm run typecheck
npm run test
npm run build
node .\dist\index.js --help

给 AI Agent 的入口建议

如果后续要配 skill / agent 使用这套 CLI，建议约定以下入口顺序：

1. 先读 docs/first-run.md
2. 再读 docs/troubleshooting.md
3. 最后再执行 coding-cli auth whoami、coding-cli task list 等命令

这样可以把“首次授权需要人工处理”这个事实提前讲清楚，避免 agent 把网页登录验证码误当成 CLI 故障。

Practical Notes

• Use coding-cli task meta releases --project nuohua to find the version/release code before attaching tasks to a release.
• Use coding-cli task create --release-code 30231 or coding-cli task update --release-code 30231 to attach tasks to one or more CODING releases.
• Use comma-separated release codes when one task belongs to multiple releases, for example --release-code 30231,30218.
• CODING rejects past due dates in the platform field. For historical backfill tasks, keep the original due date in the description text instead of forcing --due-date.
• The CLI sends due dates as end-of-day timestamps so create/update now follow the same time format.

OpenSpec

本目录使用本地 OpenSpec：

• 变更目录：openspec/changes/
• 当前 Phase 1 change：coding-cli-phase1-task-crud

常用命令：

openspec status --change "coding-cli-phase1-task-crud" --json
openspec instructions apply --change "coding-cli-phase1-task-crud" --json
openspec validate coding-cli-phase1-task-crud