@leeguoo/zentao-mcp 0.5.4 → 0.5.6

package/README.md

@@ -172,3 +172,7 @@ pnpm test
 ## Security
 
 Do not commit credentials. Prefer environment variables in local runs.
+
+## Skill
+
+For OpenClaw (AgentSkills-compatible), see `skills/zentao/SKILL.md`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leeguoo/zentao-mcp",
-  "version": "0.5.4",
+  "version": "0.5.6",
   "description": "ZenTao CLI for products + bugs",
   "keywords": [
     "zentao",

package/skills/zentao/SKILL.md

@@ -0,0 +1,90 @@
+---
+name: zentao
+description: Use the zentao CLI to login and query ZenTao products and bugs. ZENTAO_URL usually includes /zentao.
+homepage: https://www.npmjs.com/package/@leeguoo/zentao-mcp
+metadata: {"openclaw":{"emoji":"🐞","install":[{"id":"node","kind":"node","package":"@leeguoo/zentao-mcp","bins":["zentao"],"label":"Install zentao CLI (node)"}]}}
+---
+
+# zentao (ZenTao CLI)
+
+## When to use this skill
+
+Use this skill when the user asks to:
+
+- login to ZenTao via the CLI
+- list products
+- list bugs for a product
+- view bug details
+- list the user's own bugs
+
+## Installation (recommended)
+
+To install globally with pnpm:
+
+```bash
+pnpm i -g @leeguoo/zentao-mcp
+```
+
+If pnpm is not installed:
+
+```bash
+npm i -g pnpm
+pnpm i -g @leeguoo/zentao-mcp
+```
+
+## Login workflow
+
+1) Run login once:
+
+```bash
+zentao login \
+  --zentao-url="https://zentao.example.com/zentao" \
+  --zentao-account="leo" \
+  --zentao-password="***"
+```
+
+2) This writes credentials to:
+
+- `~/.config/zentao/config.toml` (or `$XDG_CONFIG_HOME/zentao/config.toml`)
+
+3) Verify:
+
+```bash
+zentao whoami
+```
+
+IMPORTANT: `--zentao-url` usually must include `/zentao`.
+If login returns HTML 404, the base path is likely missing `/zentao`.
+
+## Commands
+
+List products (simple by default):
+
+```bash
+zentao products list
+```
+
+List bugs for a product:
+
+```bash
+zentao bugs list --product 6
+```
+
+Get bug details:
+
+```bash
+zentao bug get --id 1329
+```
+
+List my bugs (include details):
+
+```bash
+zentao bugs mine --status active --include-details
+```
+
+Full JSON output:
+
+- `zentao products list --json`
+- `zentao bugs list --product 6 --json`
+- `zentao bug get --id 1329 --json`
+- `zentao bugs mine --include-details --json`

package/skills/zentao-cli.md

@@ -1,167 +0,0 @@
-# zentao (ZenTao CLI)
-
-This package provides a CLI for ZenTao REST API (products + bugs).
-
-When instructing users, assume the primary workflow is:
-
-1) install with pnpm globally
-2) `zentao login` once
-3) run `zentao ...` commands without passing credentials each time
-
-## Installation
-
-Global install (recommended):
-
-```bash
-pnpm i -g @leeguoo/zentao-mcp
-```
-
-If pnpm is not installed:
-
-```bash
-npm i -g pnpm
-pnpm i -g @leeguoo/zentao-mcp
-```
-
-Or use without installing:
-
-```bash
-npx -y @leeguoo/zentao-mcp --help
-```
-
-This installs the `zentao` command (and keeps `zentao-mcp` as a compatibility alias).
-
-## Authentication
-
-Recommended: login once (stored locally):
-
-```bash
-zentao login --zentao-url=https://zentao.example.com/zentao --zentao-account=leo --zentao-password=***
-```
-
-This writes:
-
-- `~/.config/zentao/config.toml` (or `$XDG_CONFIG_HOME/zentao/config.toml`)
-
-IMPORTANT: `zentaoUrl` should usually include `/zentao`.
-If login returns 404 HTML, your base path is likely missing `/zentao`.
-
-You can pass credentials via environment variables:
-
-```bash
-export ZENTAO_URL="https://zentao.example.com/zentao"
-export ZENTAO_ACCOUNT="leo"
-export ZENTAO_PASSWORD="***"
-```
-
-Or via CLI flags:
-
-- `--zentao-url`
-- `--zentao-account`
-- `--zentao-password`
-
-## Commands
-
-### List products
-
-```bash
-zentao products list
-```
-
-By default, this prints a simple TSV table (key fields). To get full JSON:
-
-Full JSON output:
-
-```bash
-zentao products list --json
-```
-
-### List bugs for a product
-
-```bash
-zentao bugs list --product 1
-```
-
-By default, this prints a simple TSV table. To get full JSON:
-
-Full JSON output:
-
-```bash
-zentao bugs list --product 1 --json
-```
-
-### Get bug details
-
-```bash
-zentao bug get --id 123
-```
-
-By default, this prints a simple TSV (single row). To get full JSON:
-
-Full JSON output:
-
-```bash
-zentao bug get --id 123 --json
-```
-
-### List my bugs
-
-```bash
-zentao bugs mine --scope assigned --status active
-```
-
-By default, this prints a simple summary table. To include bug details:
-
-```bash
-zentao bugs mine --status active --include-details
-```
-
-Full JSON output:
-
-```bash
-zentao bugs mine --scope assigned --status active --json
-```
-
-Common options:
-
-- `--scope`: `assigned|opened|resolved|all`
-- `--status`: `active|resolved|closed|all` (supports `,` or `|` separated)
-- `--include-details`: include bug list in response
-- `--product-ids`: limit scan to specific products, e.g. `--product-ids=1,2,3`
-
-### Self test
-
-```bash
-zentao self-test
-```
-
-Use `--expected N` to make it CI-friendly (exit code 2 when mismatch):
-
-```bash
-zentao self-test --expected 0
-```
-
-## Whoami
-
-After login:
-
-```bash
-zentao whoami
-```
-
-### Release (maintainers)
-
-Requires `git`, `npm`, and `gh`.
-
-```bash
-zentao release patch --dry-run
-```
-
-Recommended publishing flow is via GitHub Actions npm Trusted Publisher (OIDC):
-
-1) bump `package.json` version
-2) create a matching tag `vX.Y.Z`
-3) push the tag to GitHub
-4) workflow `publish-npm.yml` publishes to npm
-
-If you use Actions publishing, prefer `zentao release patch --skip-publish` locally.