yuque-cookie-plugin 0.1.0

package/skills/yuque-cookie-plugin/commands.yaml

@@ -0,0 +1,61 @@
+# yuque-cookie-plugin command registry
+
+auth.login:
+  cli: "yuque-local auth login"
+  description: "Open a local browser page for Yuque cookie setup"
+  optional: ["--manual", "--port", "--home-url", "--session", "--ctoken"]
+  example: "yuque-local auth login --manual"
+  reference: "reference/agent-spec.md"
+
+auth.status:
+  cli: "yuque-local auth status"
+  description: "Check saved credential metadata and optionally validate against a Yuque URL"
+  optional: ["<doc-or-book-url>", "--json"]
+  example: "yuque-local auth status https://www.yuque.com/user/book --json"
+  reference: "reference/agent-spec.md"
+
+doctor:
+  cli: "yuque-local doctor"
+  description: "Inspect CLI version, runtime, auth config path, and skill install status"
+  optional: ["--json"]
+  example: "yuque-local doctor --json"
+  reference: "reference/agent-spec.md"
+
+skill.install:
+  cli: "yuque-local skill install"
+  description: "Install this AI skill into local supported agent skill directories"
+  optional: ["--json"]
+  example: "yuque-local skill install --json"
+  reference: "reference/agent-spec.md"
+
+book.download:
+  cli: "yuque-local book download"
+  description: "Download a Yuque knowledge base with resources and reports"
+  required: ["<book-url>"]
+  optional: ["--dist-dir", "--incremental", "--quiet", "--json"]
+  example: "yuque-local book download https://www.yuque.com/user/book --dist-dir download --incremental --quiet --json"
+  reference: "reference/agent-spec.md"
+
+doc.create:
+  cli: "yuque-local doc create"
+  description: "Create a Yuque document from Markdown and optionally apply native Lake heading numbering"
+  required: ["<book-url>", "--title", "--markdown-file"]
+  optional: ["--number-headings", "--slug", "--no-toc", "--json"]
+  example: "yuque-local doc create https://www.yuque.com/user/book --title Title --markdown-file article.md --number-headings --json"
+  reference: "reference/agent-spec.md"
+
+doc.snapshot:
+  cli: "yuque-local doc snapshot"
+  description: "Create a local snapshot before editing"
+  required: ["<doc-url>", "--out"]
+  optional: ["--json"]
+  example: "yuque-local doc snapshot https://www.yuque.com/user/book/doc --out /tmp/doc.snapshot.json --json"
+  reference: "reference/agent-spec.md"
+
+doc.apply_lake:
+  cli: "yuque-local doc apply-lake"
+  description: "Apply Lake content to a document with built-in backup/report safeguards"
+  required: ["<doc-url>", "--lake-file"]
+  optional: ["--dry-run", "--json"]
+  example: "yuque-local doc apply-lake https://www.yuque.com/user/book/doc --lake-file body_asl.html --dry-run --json"
+  reference: "reference/agent-spec.md"

package/skills/yuque-cookie-plugin/reference/agent-spec.md

@@ -0,0 +1,51 @@
+# Agent Spec
+
+Use `yuque-local` as the only execution surface. This project is a local CLI automation tool, not an MCP service and not an OpenAPI token wrapper.
+
+## JSON Contract
+
+When `--json` is passed, commands should prefer a stable envelope:
+
+```json
+{
+  "status": "success",
+  "message": "operation completed",
+  "data": {},
+  "error": null,
+  "metadata": {}
+}
+```
+
+Some legacy calls without `--json` may return raw JSON objects or short prose. For agent automation, pass `--json`.
+
+## Auth
+
+Use:
+
+```bash
+yuque-local auth status <url> --json
+```
+
+If auth is missing or expired, stop and ask the user to run:
+
+```bash
+yuque-local auth login
+```
+
+For Docker, SSH, or headless terminals:
+
+```bash
+yuque-local auth login --manual
+```
+
+Never request raw cookie values in the conversation.
+
+## Safe Write Flow
+
+1. Snapshot the online document.
+2. Generate or transform content locally.
+3. Run `--dry-run` when supported.
+4. Apply only after the user approves the intended target and content.
+5. Keep report paths from stdout for audit.
+
+Do not delete, replace, or batch-update documents unless the user explicitly asked for that operation.