guild-shared
GitHub用于配置和认证 Guild CLI，以便通过终端或 Agent 操作里程碑、迭代或工单。支持 API Key 登录及项目初始化，确保在运行相关命令前完成环境设置与权限验证。
触发场景
安装
npx skills add NeverSight/learn-skills.dev --skill guild-shared -g -y
SKILL.md
Frontmatter
{
"name": "guild-shared",
"metadata": {
"requires": {
"bins": [
"guild"
],
"cliHelp": "guild --help"
}
},
"description": "Authenticate and configure the Guild CLI before operating milestones, iterations, or tickets. Use when the user asks to use guild CLI, configure API access, or work with Guild resources via terminal or agent."
}
guild-shared
Overview
The guild CLI is a thin HTTP client for the Adventurer Public API. It does not access the database directly. All operations require a valid API key and project ID.
When to use
- Before any
guild milestone,guild iteration, orguild ticketcommand. - When the user wants to automate Guild workflows from the terminal or from an agent.
- When unsure about global flags or auth setup.
Prerequisites
- API reachable at default
https://api.adventurer-next.36node.com, or locally (--api-url http://localhost:3002). - API key from Guild Web (Settings → API Keys), or username/password (
POST /auth/@login). guildinstalled globally or vianpx @adventurer-tech/guild-cli.
Setup
npm install -g @adventurer-tech/guild-cli
# Password login (Guild account)
guild auth login --username <username> --password '<password>'
# Or API key from Guild Web → Settings → API Keys
guild auth login --api-key <key>
guild config init --project-id <projectId>
guild auth status
Default API: https://api.adventurer-next.36node.com. Local dev: --api-url http://localhost:3002.
Config locations
| File | Contents | Commit? |
|---|---|---|
~/.config/guild/credentials.json |
apiKey, optional apiUrl |
Never |
.guild/config.json |
projectId, optional apiUrl |
Yes |
Override per invocation: --project-id, --api-url.
Output
Default JSON: { "ok": true, "data": ... }. On failure, { "ok": false, "error": { "code", "message" } } and exit code 1.
Use --pretty for indented JSON.
API custom verbs
Non-CRUD actions use POST …/@verb for ticket state (publish, unpublish, close, reopen) and POST …/actions/@verb for workflow (take, untake, submit, approve, reject). Sub-resources use PUT.
Help
When parameters are unclear, run help first:
guild --help
guild auth --help
guild config --help
Security
- Never write API keys into repo files, skills, or commit messages.
- Never echo or log the
x-api-keyheader.
Install skills
npx skills add adventurer-tech/guild-skills -y -g
版本历史
- c3c0a1e 当前 2026-07-23 11:05
依赖关系
-
suggested
adventurer-tech/guild-skills
