@thinkingai/ae-cli 6.0.24 → 6.0.28

package/skills/ae-agent/references/add-model.md

@@ -0,0 +1,70 @@
+# agent +add-model (Add Custom Model)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
+
+Domain: **Models / write**
+
+## Use Cases
+- Add a custom model to the personal or company scope.
+- Returns the newly created model object including its `id`.
+- `--scope personal` (default) creates a personal model; `--scope company` creates a company model (requires root/agent_admin).
+
+## Mandatory Rules (MUST)
+- `--model-id`, `--name`, and `--base-url` are required.
+- `--base-url` must be a valid URL.
+- `--scope` controls target scope: `personal` (default) or `company`. Company scope requires root/agent_admin; system models are read-only.
+- Write operation: keep the confirmation prompt unless `--yes` is explicitly requested.
+
+## Command
+```bash
+ae-cli agent +add-model \
+  --model-id gpt-4o \
+  --name "GPT-4o" \
+  --base-url "https://api.openai.com/v1" \
+  --api-key "sk-xxx" \
+  --provider openai
+
+ae-cli agent +add-model \
+  --model-id claude-sonnet \
+  --name "Claude Sonnet" \
+  --base-url "https://api.anthropic.com/v1" \
+  --provider anthropic \
+  --context-length 200000 \
+  --yes
+
+# Dry-run to inspect the request before executing
+ae-cli agent +add-model --dry-run --model-id gpt-4o --name "GPT-4o" --base-url "https://api.openai.com/v1"
+
+# Company scope (requires root/agent_admin)
+ae-cli agent +add-model \
+  --model-id gpt-4o-company \
+  --name "GPT-4o (company)" \
+  --base-url "https://api.openai.com/v1" \
+  --provider openai \
+  --scope company \
+  --yes
+```
+
+## Parameters
+| Parameter | Required | Description |
+|---|---|---|
+| `--model-id` | Yes | Model identifier (e.g. `gpt-4o`) |
+| `--name` | Yes | Display name |
+| `--base-url` | Yes | API base URL (must be a valid URL) |
+| `--api-key` | No | API key |
+| `--provider` | No | Provider name |
+| `--description` | No | Description |
+| `--context-length` | No | Context window length |
+| `--scope` | No | Target scope: `personal` (default) or `company` (requires root/agent_admin) |
+
+## Decision Rules
+- If the user provides a model spec, map the model identifier to `--model-id` and the human name to `--name`.
+- `--api-key` is optional at the CLI level but usually required by the upstream provider; pass it when the user supplies one.
+- Use `--dry-run` first to verify the request shape before executing.
+
+## Next Steps on Failure
+- `--base-url must be a valid URL`: check the URL formatting.
+- After success, capture the returned `id` for `+toggle-model` / `+del-model` calls.
+
+## Recommended Chaining
+- `+list-models` (verify) → `+add-model` → `+toggle-model` (enable) → `+create-automation --model <id>`

package/skills/ae-agent/references/add-skill.md

@@ -0,0 +1,71 @@
+# agent +add-skill (Create Custom Skill)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
+
+Domain: **Skills / write**
+
+## Use Cases
+- Create a custom Skill in the personal or company scope.
+- Returns the newly created Skill object including its `id`.
+- `--scope personal` (default) creates a personal Skill; `--scope company` creates a company Skill (requires root/agent_admin). Company scope bypasses the submit-approve flow — the Skill is directly created as a company asset (consistent with `+upload-skill --scope company`).
+- Optional market meta (`--category` / `--icon-emoji` / `--icon-color`) is applied via a follow-up PATCH to `/api/sandbox/agent/skills/[id]/meta`.
+
+## Mandatory Rules (MUST)
+- `--name`, `--description`, and `--instructions` are required.
+- `--name` must be 1–80 chars.
+- `--instructions` supports `@-` to read from stdin (useful for piping long instruction text).
+- `--category` must be one of the market category keys (see below) when provided.
+- `--scope` controls target scope: `personal` (default) or `company`. Company scope requires root/agent_admin and bypasses the submit-approve flow (directly creates a company Skill, consistent with `+upload-skill --scope company`).
+- Write operation: keep the confirmation prompt unless `--yes` is explicitly requested.
+
+## Market Category Keys
+`ae_preset | dev_tool | search_tool | data_query | content_gen | enterprise | life | automation | other`
+
+## Command
+```bash
+# Inline instructions
+ae-cli agent +add-skill \
+  --name code-reviewer \
+  --description "Reviews code for best practices" \
+  --instructions "You are a code reviewer. Analyze the code for..."
+
+# Instructions from stdin (useful for long text)
+echo "You are a helpful assistant that..." | \
+  ae-cli agent +add-skill --name helper --description "Helper skill" --instructions @-
+
+# With market category and icon
+ae-cli agent +add-skill \
+  --name code-reviewer \
+  --description "Reviews code for best practices" \
+  --instructions "You are a code reviewer..." \
+  --category dev_tool \
+  --icon-emoji robot \
+  --yes
+
+# Dry-run to inspect the request before executing
+ae-cli agent +add-skill --dry-run --name helper --description "Helper" --instructions "x"
+```
+
+## Parameters
+| Parameter | Required | Description |
+|---|---|---|
+| `--name` | Yes | Skill name (1–80 chars) |
+| `--description` | Yes | Skill description |
+| `--instructions` | Yes | Skill instructions (use `@-` to read from stdin) |
+| `--display-name` | No | Display name (max 100) |
+| `--category` | No | Market category key (see above) |
+| `--icon-emoji` | No | Market icon emoji (e.g. `robot`) |
+| `--icon-color` | No | Market icon color (e.g. `#1E76F0`) |
+| `--scope` | No | Target scope: `personal` (default) or `company` (requires root/agent_admin; bypasses submit-approve flow) |
+
+## Decision Rules
+- If the user provides long instruction text, pipe it via stdin with `--instructions @-` instead of an oversized inline string.
+- `--category` / `--icon-emoji` / `--icon-color` are optional market meta; they are applied via a follow-up PATCH after creation. If the meta update fails, the Skill is still created and a warning is printed to stderr.
+- Use `--dry-run` first to verify the request shape before executing.
+
+## Next Steps on Failure
+- `stdin is empty; cannot read instructions`: ensure stdin has content when using `@-`.
+- Warning `Skill created but meta update failed`: the Skill exists; retry the meta with `+set-skill-meta`.
+
+## Recommended Chaining
+- `+add-skill` → `+list-skills` (verify) → `+set-skill-meta` (adjust meta) → `+submit-skill` (publish) or `+share-skill` (peer share)

package/skills/ae-agent/references/approve-skill.md

@@ -0,0 +1,41 @@
+# agent +approve-skill (Approve Skill Submission)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
+
+Domain: **Skill Approval (company-scope publish) / write**
+
+## Use Cases
+- Approve a pending Skill submission (root only).
+- Endpoint: `POST /api/sandbox/agent/skills/submissions/[id]/approve`.
+- Approving creates an independent company-scope copy of the Skill.
+- Approval is Skill-only — MCP has no approval flow.
+
+## Mandatory Rules (MUST)
+- `--id` is required and must reference a **submission** record (CUID), not a Skill ID. Obtain it via `+list-skill-submissions` — do not guess.
+- **Root only** — non-root users cannot approve submissions.
+- Write operation: keep the confirmation prompt unless `--yes` is explicitly requested.
+- Only `pending` submissions can be approved.
+
+## Command
+```bash
+ae-cli agent +approve-skill --id <submission-cuid> --yes
+ae-cli agent +approve-skill --dry-run --id <submission-cuid>
+```
+
+## Parameters
+| Parameter | Required | Description |
+|---|---|---|
+| `--id` | Yes | Submission record ID (CUID) |
+
+## Decision Rules
+- `--id` here is a submission ID (not a Skill ID).
+- Use this after reviewing a pending submission (`+list-skill-submissions --status pending`).
+- Approving creates a company-scope copy; the original personal Skill remains.
+- Cannot approve a submission that is already `approved` / `rejected` / `cancelled`.
+
+## Next Steps on Failure
+- `404` / not found: re-run `+list-skill-submissions --status pending` to verify the submission ID.
+- Permission error: the current user is not root.
+
+## Recommended Chaining
+- `+list-skill-submissions --status pending` → confirm submission `id` → `+approve-skill` (or `+reject-skill`)

package/skills/ae-agent/references/attachment-stats.md

@@ -0,0 +1,50 @@
+# agent +attachment-stats (Attachment Library Statistics)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
+
+Domain: **Attachments / read**
+
+## Use Cases
+- Show the current user's attachment library statistics: total file count, total size, image count, document count.
+- Endpoint: `GET /api/sandbox/agent/attachments/stats`.
+- No parameters; returns a single statistics object for the authenticated user's own data.
+
+## Mandatory Rules (MUST)
+- No flags. The command always returns the current user's own attachment statistics.
+
+## Command
+```bash
+ae-cli agent +attachment-stats
+
+# Dry-run to inspect the request
+ae-cli agent +attachment-stats --dry-run
+```
+
+## Parameters
+| Parameter | Required | Description |
+|---|---|---|
+| _(none)_ | — | This command takes no flags. |
+
+## Response Shape
+```json
+{
+  "totalCount": 42,
+  "totalSize": 10485760,
+  "imageCount": 15,
+  "documentCount": 27
+}
+```
+
+| Field | Description |
+|---|---|
+| `totalCount` | Total number of ready attachments |
+| `totalSize` | Total size in bytes (sum of all ready attachments) |
+| `imageCount` | Number of image attachments (type=image) |
+| `documentCount` | Number of document attachments (type=document) |
+
+## Next Steps on Failure
+- `500` 获取附件统计失败: an internal aggregation error — retry, then contact the platform maintainer if it persists.
+
+## Recommended Chaining
+- `+attachment-stats` (overview) → `+list-attachments` (drill into the list)
+- `+add-attachment` (upload) → `+attachment-stats` (verify totals changed)

package/skills/ae-agent/references/auto-provision-mcp-credentials.md

@@ -0,0 +1,57 @@
+# agent +auto-provision-mcp-credentials (Auto-Provision MCP Credentials)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
+
+Domain: **MCP Credentials / write**
+
+## Use Cases
+- Auto-provision per-user credentials for all system-scope MCP servers in one call.
+- Endpoint: `POST /api/sandbox/agent/mcp-credentials/auto-provision`.
+- Uses the current user's access token to mint MCP tokens via the central token-generation endpoint.
+- For `useMcpToken=true` system servers, a shared MCP token is generated and stored; for OAuth system servers, the access token is stored as the credential.
+
+## Mandatory Rules (MUST)
+- `--access-token` is optional; when omitted, the current session token is used automatically (via `ctx.token()`).
+- The access token must be valid — an invalid/expired token causes the MCP token generation to fail (reported via `mcpTokenFailed: true` in the response).
+- Write operation: keep the confirmation prompt unless `--yes` is explicitly requested.
+- This is a bulk operation — it upserts credentials for ALL system MCP servers visible to the current user.
+
+## Command
+```bash
+# Auto-provision using the current session token (recommended)
+ae-cli agent +auto-provision-mcp-credentials --yes
+
+# Explicitly pass an access token
+ae-cli agent +auto-provision-mcp-credentials --access-token "eyJhbGci..." --yes
+
+# Dry-run to inspect the request
+ae-cli agent +auto-provision-mcp-credentials --dry-run
+```
+
+## Parameters
+| Parameter | Required | Description |
+|---|---|---|
+| `--access-token` | No | Access token (defaults to the current session token) |
+
+## Decision Rules
+- If the user wants to set up all system MCP credentials in one step, use this command.
+- Prefer running without `--access-token` — the CLI automatically sources the current session token.
+- The response reports `count` (total system servers processed), `mcpTokenCount` (servers that got a shared MCP token), and `mcpTokenFailed` (whether the MCP token generation failed).
+- If `mcpTokenFailed` is `true`, the MCP token endpoint may be down or the access token invalid — check the access token and retry.
+- For individual credential control, use `+set-mcp-credential` instead.
+
+## Response Shape
+```json
+{
+  "count": 3,
+  "mcpTokenCount": 1,
+  "mcpTokenFailed": false
+}
+```
+
+## Next Steps on Failure
+- `401` / auth expired: run `ae-cli auth login`, then retry.
+- `mcpTokenFailed: true`: the MCP token generation failed — verify the access token is valid and the MCP token endpoint is configured.
+
+## Recommended Chaining
+- `ae-cli auth login` → `+auto-provision-mcp-credentials` → `+list-mcp-credentials` (verify) → `+mcp-token` (get shared token)

package/skills/ae-agent/references/cancel-skill-submission.md

@@ -0,0 +1,39 @@
+# agent +cancel-skill-submission (Cancel Skill Submission)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
+
+Domain: **Skill Approval (company-scope publish) / write**
+
+## Use Cases
+- Cancel a pending Skill submission.
+- Endpoint: `POST /api/sandbox/agent/skills/submissions/[id]/cancel`.
+- Only pending submissions can be cancelled; the submitter or root can cancel.
+- Approval is Skill-only — MCP has no approval flow.
+
+## Mandatory Rules (MUST)
+- `--id` is required and must reference a **submission** record (CUID), not a Skill ID. Obtain it via `+list-skill-submissions` — do not guess.
+- Only the submitter or root can cancel a submission.
+- Write operation: keep the confirmation prompt unless `--yes` is explicitly requested.
+
+## Command
+```bash
+ae-cli agent +cancel-skill-submission --id <submission-cuid> --yes
+ae-cli agent +cancel-skill-submission --dry-run --id <submission-cuid>
+```
+
+## Parameters
+| Parameter | Required | Description |
+|---|---|---|
+| `--id` | Yes | Submission record ID (CUID) |
+
+## Decision Rules
+- `--id` here is a submission ID (not a Skill ID) — `+submit-skill` / `+share-skill` / `+copy-skill` take a Skill ID instead.
+- Use this when the submitter wants to withdraw a pending submission before review.
+- Cannot cancel a submission that is already `approved` / `rejected` / `cancelled`.
+
+## Next Steps on Failure
+- `404` / not found: re-run `+list-skill-submissions --status pending` to verify the submission ID.
+- Permission error: only the submitter or root can cancel.
+
+## Recommended Chaining
+- `+list-skill-submissions --status pending` → confirm submission `id` → `+cancel-skill-submission`

package/skills/ae-agent/references/copy-skill.md

@@ -0,0 +1,53 @@
+# agent +copy-skill (Copy Skill to Personal)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
+
+Domain: **Copy to personal / write**
+
+## Use Cases
+- Copy a system/company Skill to an independent personal copy.
+- Endpoint: `POST /api/sandbox/agent/skills/[id]/copy`.
+- The copy is an independent duplicate — changes to the source do not affect the copy and vice versa.
+- Optional `--category` / `--icon-emoji` / `--icon-color` override the copy's market meta; omit them to inherit the source's.
+
+## Mandatory Rules (MUST)
+- `--id` is required. Obtain the real source Skill record ID (CUID, system or company scope) via `+list-skill-market` or `+list-skills` — do not guess.
+- `--category` must be one of the market category keys (see below) when provided.
+- Write operation: keep the confirmation prompt unless `--yes` is explicitly requested.
+- MCP has no copy flow (use `+toggle-mcp` to enable a system/company MCP per-user).
+
+## Market Category Keys
+`ae_preset | dev_tool | search_tool | data_query | content_gen | enterprise | life | automation | other`
+
+## Command
+```bash
+# Copy with inherited meta
+ae-cli agent +copy-skill --id <skill-cuid> --yes
+
+# Copy with overridden category and icon
+ae-cli agent +copy-skill --id <skill-cuid> --category dev_tool --icon-emoji robot --yes
+
+# Dry-run to inspect the request before executing
+ae-cli agent +copy-skill --dry-run --id <skill-cuid>
+```
+
+## Parameters
+| Parameter | Required | Description |
+|---|---|---|
+| `--id` | Yes | Source Skill record ID (CUID, system or company scope) |
+| `--category` | No | Market category key for the copy (see above) |
+| `--icon-emoji` | No | Override market icon emoji (e.g. `robot`) |
+| `--icon-color` | No | Override market icon color (e.g. `#1E76F0`) |
+
+## Decision Rules
+- If the user wants a personal version of a system/company Skill, use `+copy-skill` (not `+add-skill`).
+- Omit `--category` / `--icon-emoji` / `--icon-color` to inherit the source's meta; provide them to override.
+- MCP has no copy — to use a system/company MCP, toggle it on per-user with `+toggle-mcp`.
+- Use `--dry-run` first to verify the request shape before executing.
+
+## Next Steps on Failure
+- `--category must be one of...`: use one of the category keys.
+- `404` / not found: re-run `+list-skill-market` / `+list-skills` to verify the source Skill ID and scope.
+
+## Recommended Chaining
+- `+list-skill-market` (browse) → `+copy-skill` (copy to personal) → `+list-skills` (verify) → `+set-skill-meta` (adjust)

package/skills/ae-agent/references/create-agent.md

@@ -0,0 +1,71 @@
+# agent +create-agent (Create Agent)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
+
+Domain: **Agents / write**
+
+## Use Cases
+- Create a new Agent in the personal scope (default) or company scope (requires root/agent_admin).
+- Returns the newly created Agent object including its `id`.
+- Wire up an existing model, MCP servers, and Skills in one call.
+
+## Mandatory Rules (MUST)
+- `--name` is required (1–100 chars).
+- `--scope` defaults to `personal`; `company` requires root/agent_admin privileges.
+- `--instructions` maps to the Agent's system prompt; supports `@-` to read from stdin.
+- `--mcp-ids` / `--skill-ids` must be JSON array strings when provided.
+- Write operation: keep the confirmation prompt unless `--yes` is explicitly requested.
+- Do not guess model / MCP / Skill IDs. Discover them with `+list-*` commands first.
+
+## Command
+```bash
+# Minimal create
+ae-cli agent +create-agent --name "daily-report" --description "Daily report agent"
+
+# With model, MCP servers, and Skills
+ae-cli agent +create-agent \
+  --name "daily-report" \
+  --description "Daily report agent" \
+  --model-id "cm1uuid" \
+  --mcp-ids '["mcp-cuid-1","mcp-cuid-2"]' \
+  --skill-ids '["skill-cuid-1"]' \
+  --yes
+
+# Instructions from stdin (useful for long prompts)
+echo "You are a helpful assistant that..." | \
+  ae-cli agent +create-agent --name helper --instructions @-
+
+# Auto-rename on name conflict (appends -1, -2, ...)
+ae-cli agent +create-agent --name "daily-report" --auto-rename --yes
+
+# Dry-run to inspect the request before executing
+ae-cli agent +create-agent --dry-run --name "daily-report" --description "x"
+```
+
+## Parameters
+| Parameter | Required | Description |
+|---|---|---|
+| `--name` | Yes | Agent name (1–100 chars) |
+| `--description` | No | Agent description (max 2000 chars) |
+| `--instructions` | No | Agent system prompt (use `@-` to read from stdin) |
+| `--scope` | No | `personal` \| `company` (default `personal`; `company` requires root/agent_admin) |
+| `--model-id` | No | Model identifier (`Model.id` uuid or legacy `modelId`); omit to use the global default |
+| `--mcp-ids` | No | MCP server record IDs as JSON array string (e.g. `["id1","id2"]`) |
+| `--skill-ids` | No | Skill record IDs as JSON array string |
+| `--auto-rename` | No | Auto-rename on name conflict (append `-N` suffix) |
+
+## Decision Rules
+- If the user provides long instruction text, pipe it via stdin with `--instructions @-` instead of an oversized inline string.
+- `--model-id` accepts both the model record UUID and the legacy model identifier; the server resolves and stores the UUID. Omit it to use the global default model.
+- `--mcp-ids` / `--skill-ids` replace the full list on create; pass `[]` or omit to leave the list empty.
+- Use `--dry-run` first to verify the request shape before executing.
+- On name conflict, the server returns `409 NAME_EXISTS`; pass `--auto-rename` to auto-resolve.
+
+## Next Steps on Failure
+- `Agent 名称已存在` (409): re-run with `--auto-rename`, or pick a different `--name`.
+- `模型不存在或已删除`: verify the model ID with `+list-models`.
+- `MCP 数量超过上限` / `Skill 数量超过上限`: reduce the IDs in `--mcp-ids` / `--skill-ids`.
+- `stdin is empty; cannot read instructions`: ensure stdin has content when using `@-`.
+
+## Recommended Chaining
+- `+list-models` / `+list-mcps` / `+list-skills` (discover IDs) → `+create-agent` → `+get-agent` (verify) → `+create-automation --agent-id <id>`

package/skills/ae-agent/references/create-automation.md

@@ -0,0 +1,99 @@
+# agent +create-automation (Create Automation)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
+
+Domain: **Automations / write**
+
+## Use Cases
+- Create an Agent automation task that runs on a schedule (hourly / daily / weekly / monthly or cron).
+- Returns the newly created automation object including its `id` and initial `status`.
+- Automations are **enabled by default**; pass `--enabled false` only when the user explicitly asks to create the task without enabling it.
+
+## Mandatory Rules (MUST)
+- `--name` and `--message` are required.
+- A schedule is required: provide either `--cron` or a `--schedule-kind` (with its time/day fields). `--cron` and `--schedule-kind` are mutually exclusive.
+- `--agent-id` and `--agent-name` are mutually exclusive. Obtain a real Agent ID via `+list-agents` — do not guess.
+- JSON flags must be valid JSON strings, usually wrapped in single quotes in shell.
+- Write operation: keep the confirmation prompt unless `--yes` is explicitly requested.
+- Do not surface raw automation IDs, raw JSON, or concrete detail paths in user-facing replies.
+
+## Schedule Kinds
+| `--schedule-kind` | Required fields | Notes |
+|---|---|---|
+| `hourly` | `--minute` (optional, 0–59) | Runs every hour at the given minute |
+| `daily` | `--time HH:mm` | Runs once a day at the given time |
+| `weekly` | `--time HH:mm`, `--weekday 0-6` | `0` = Sunday |
+| `monthly` | `--time HH:mm`, `--day-of-month 1-28` | Day 1–28 only |
+
+## Command
+```bash
+# Enabled daily automation (default)
+ae-cli agent +create-automation \
+  --name "Daily AI Brief" \
+  --schedule-kind daily \
+  --time 09:00 \
+  --message "Summarize yesterday's AI news" \
+  --yes
+
+# Create but keep paused when the user explicitly asks not to enable it
+ae-cli agent +create-automation \
+  --name "Daily AI Brief" \
+  --schedule-kind daily \
+  --time 09:00 \
+  --message "Summarize yesterday's AI news" \
+  --enabled false \
+  --yes
+
+# Weekly schedule on Sunday
+ae-cli agent +create-automation \
+  --name "Weekly Report" \
+  --schedule-kind weekly \
+  --time 10:00 \
+  --weekday 0 \
+  --message "Generate the weekly report" \
+  --yes
+
+# Cron expression
+ae-cli agent +create-automation \
+  --name "Cron Task" \
+  --cron "0 9 * * 1-5" \
+  --message "Weekday morning brief" \
+  --yes
+
+# Dry-run to inspect the request before executing
+ae-cli agent +create-automation --dry-run --name "Test" --message "x" --schedule-kind daily --time 09:00
+```
+
+## Parameters
+| Parameter | Required | Description |
+|---|---|---|
+| `--name` | Yes | Automation task name |
+| `--message` | Yes | Instruction sent to the Agent |
+| `--cron` | No* | Cron expression (mutually exclusive with `--schedule-kind`) |
+| `--schedule-kind` | No* | `hourly` \| `daily` \| `weekly` \| `monthly` |
+| `--time` | No | Time in `HH:mm` for daily/weekly/monthly |
+| `--minute` | No | Minute 0–59 for hourly schedules |
+| `--weekday` | No | Weekday 0–6 for weekly schedules; `0` is Sunday |
+| `--day-of-month` | No | Day 1–28 for monthly schedules |
+| `--agent-id` | No | Agent ID; defaults to current conversation Agent |
+| `--agent-name` | No | Agent name; use only after `+list-agents` discovery |
+| `--model` | No | Model record ID; defaults to current selected model |
+| `--enabled` | No | `true` (default) \| `false` |
+| `--conversation-id` | No | Conversation ID fallback for resolving current Agent |
+
+\* One of `--cron` or `--schedule-kind` is required.
+
+## Decision Rules
+- If the user provides a natural-language schedule ("every day at 9am"), translate it to `--schedule-kind daily --time 09:00`.
+- If the user wants a cron-only schedule not covered by the kinds, use `--cron`.
+- If no Agent is specified, the automation targets the current conversation's Agent; verify with `+list-agents` when in doubt.
+- Use `--dry-run` first to verify the request shape before executing.
+
+## Next Steps on Failure
+- `必须提供 --cron 或 --schedule-kind`: provide one of the schedule flags.
+- `--time 格式必须是 HH:mm`: use 24-hour `HH:mm` (e.g. `09:00`).
+- `--agent-id 与 --agent-name 只能二选一`: pick one and remove the other.
+- After success, capture the returned `id` for subsequent `+update-automation` calls.
+
+## Recommended Chaining
+- `+list-agents` → `+create-automation` → `+list-automations` (verify) → `+update-automation` (edit)

package/skills/ae-agent/references/del-agent.md

@@ -0,0 +1,38 @@
+# agent +del-agent (Delete Agent)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
+
+Domain: **Agents / write**
+
+## Use Cases
+- Soft-delete an Agent (personal owner or company root/agent_admin; system Agents cannot be deleted).
+- The Agent is marked deleted and its name is suffixed to free the unique index; no cascade deletion of related resources.
+
+## Mandatory Rules (MUST)
+- `--id` is required. Obtain the real Agent record ID (CUID) via `+list-agents` — do not guess.
+- System Agents cannot be deleted via CLI.
+- Prefer `--dry-run` before executing a destructive delete.
+- Write operation: keep the confirmation prompt unless `--yes` is explicitly requested.
+
+## Command
+```bash
+ae-cli agent +del-agent --id <agent-cuid> --yes
+ae-cli agent +del-agent --dry-run --id <agent-cuid>
+```
+
+## Parameters
+| Parameter | Required | Description |
+|---|---|---|
+| `--id` | Yes | Agent record ID (CUID) |
+
+## Decision Rules
+- Confirm the Agent ID with `+list-agents` before deleting.
+- Deletion is soft — historical automations referencing the Agent may need re-pointing afterwards.
+- Only `personal` Agents (owner) and `company` Agents (root/agent_admin) can be deleted; `system` returns `403`.
+
+## Next Steps on Failure
+- `404` / `Agent 不存在`: re-run `+list-agents` to verify the Agent ID.
+- `403` / `系统 Agent 不允许删除` / `无权删除该 Agent`: system Agents are protected; company Agents require root/agent_admin.
+
+## Recommended Chaining
+- `+list-agents` → confirm `id` → `+del-agent` → `+list-agents` (verify gone)

package/skills/ae-agent/references/del-attachment.md

@@ -0,0 +1,35 @@
+# agent +del-attachment (Delete Attachment)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
+
+Domain: **Attachments / write**
+
+## Use Cases
+- Soft-delete an attachment.
+- Endpoint: `DELETE /api/sandbox/agent/attachments?id=[id]`.
+
+## Mandatory Rules (MUST)
+- `--id` is required. Obtain the real attachment ID via `+list-attachments` — do not guess.
+- This is a soft delete — prefer `--dry-run` before executing.
+- Write operation: keep the confirmation prompt unless `--yes` is explicitly requested.
+
+## Command
+```bash
+ae-cli agent +del-attachment --id <attachment-id> --yes
+ae-cli agent +del-attachment --dry-run --id <attachment-id>
+```
+
+## Parameters
+| Parameter | Required | Description |
+|---|---|---|
+| `--id` | Yes | Attachment ID |
+
+## Decision Rules
+- Confirm the attachment ID with `+list-attachments` before deleting.
+- This is a soft delete, not a physical removal.
+
+## Next Steps on Failure
+- `404` / not found: re-run `+list-attachments` to verify the attachment ID.
+
+## Recommended Chaining
+- `+list-attachments` → confirm `id` → `+del-attachment`

package/skills/ae-agent/references/del-mcp.md

@@ -0,0 +1,35 @@
+# agent +del-mcp (Delete Personal MCP Server)
+
+> **Prerequisite:** Follow the Global AE CLI Rules in [`../SKILL.md`](../SKILL.md).
+
+Domain: **MCP Servers / write**
+
+## Use Cases
+- Delete a personal-scope MCP server.
+- Only `personal` scope MCP servers can be deleted via CLI; company/system servers are read-only.
+
+## Mandatory Rules (MUST)
+- `--id` is required. Obtain the real MCP server record ID (CUID) via `+list-mcps` — do not guess.
+- Prefer `--dry-run` before executing a destructive delete.
+- Write operation: keep the confirmation prompt unless `--yes` is explicitly requested.
+
+## Command
+```bash
+ae-cli agent +del-mcp --id <mcp-cuid> --yes
+ae-cli agent +del-mcp --dry-run --id <mcp-cuid>
+```
+
+## Parameters
+| Parameter | Required | Description |
+|---|---|---|
+| `--id` | Yes | MCP server record ID (CUID) |
+
+## Decision Rules
+- Confirm the server ID with `+list-mcps` before deleting.
+- If the server is company/system scope, deletion is not available via CLI (use `+toggle-mcp` to disable it per-user instead).
+
+## Next Steps on Failure
+- `404` / not found: re-run `+list-mcps` to verify the server ID and scope.
+
+## Recommended Chaining
+- `+list-mcps` → confirm `id` → `+del-mcp`