SuperAPI AI Directory

zsxq

General & other

View repository

Updated 10-16 09:45

About this skill

Knowledge Planet Operation Guide (CLI / MCP dual channel)

This Skill covers all scenarios for operating Knowledge Planet via zsxq-cli (CLI channel) or the underlying interface tool call_zsxq_api (MCP channel): authentication, planet management, topic management, user information, note management, and Skill Pay WeChat payment.

By default, it is assumed that zsxq-cli is installed and logged in, so there is no need to proactively check every time. Handle it on demand only when a command execution reports an error (see references/auth-errors.md)。

All identifiers such as IDs, order numbers, and payment codes in the examples of this Skill are simulated data and do not correspond to real resources. When performing operations, the real identifiers must be obtained and verified through query results or user input, and the example values must not be reused directly.

Execution channel

All capabilities of this Skill have two execution channels; determine the channel first, then route:

  1. The host can execute zsxq-cli → CLI channel(preferred; shortcuts have parameter validation and local orchestration, so behavior is the most controllable)
  2. Otherwise, the host tool list contains call_zsxq_api → MCP channel
  3. If neither is available → stop and remind the user: install the CLI (see references/auth-errors.md) or connect the Knowledge Planet MCP in the host (create an api-key on the key management page and then copy the link to connect), and let the user choose
  • Channel determination is a one-time environment probe; once selected, use it consistently and do not mix channels. Only when an operation is marked "CLI channel only" / "MCP channel only" should you switch separately for that operation or inform the user.
  • Under the MCP channel, all calls go through the underlying interface tool call_zsxq_api(parameters {method, path, query?, body?});Do not fabricate undocumented method/path— for the capability base table, see references/endpoint-catalog.md, and anything not covered is considered unsupported.
  • The "execution mode" routing (scenario → atomic → exploration) is the same under both channels; the channel only determines which set of call blocks each reference's "## Commands" section uses.

Execution mode

Route user requests in the following order, execute on hit, and do not continue further down:

  1. Scenario mode — the request hits aregistered scenario: read the scenario entry document and orchestrate atomic operations according to the process
  2. Atomic operation — the request clearly corresponds to one common operation: read the corresponding reference and directly call the recommended command
  3. Exploration mode — nothing hits: follow references/cli-exploration.md to discover capabilities through CLI help and the API list

When executing atomic operations and scenariosmust notpre-run unrelated doctor、--help or api list. Fall back to exploration mode only when the capability does not match or the call fails.

Quick index

Based on the user's intent, jump directly to the corresponding section or reference:

The user wants to… Where to look
Log in / check login status / troubleshoot authentication or HTTP errors → references/auth-errors.md
Daily patrol: check today's new content that needs attention/handling → scenarios/daily-patrol.md
Organize the comment section, find unreplied comments and draft replies → scenarios/triage-comments.md
Handle questions others have raised to me that haven't been answered yet → scenarios/manage-inbound-questions.md
Curate featured content and tags (feature / tag suggestions) → scenarios/curate-digest-and-tags.md
Generate operations daily report / weekly report / retrospective → scenarios/compose-operations-report.md
Turn Planet content into daily report poster images (PNG) → scenarios/generate-daily-poster.md
Turn Planet posts into vertical animated videos (MP4) → scenarios/generate-video.md
Patrol and monitor negative / risky content → scenarios/monitor-risky-content.md
Batch tag topics with given tags → scenarios/batch-tag-topics.md
Expiring member renewal care (identify members about to expire, write tiered scripts) → scenarios/care-expiring-members.md
Batch collect the latest topics into columns → scenarios/archive-topics-to-column.md
Ask about product rules/features/FAQ (refunds, fees, invoicing, verification, review, bans…) → references/scenarios/answer-product-docs.md
Check/migrate/clean up the old zsxq skill → references/scenarios/migrate-legacy-skills.md
Use Skill Pay to pay to join / renew / purchase / paid questions / tips → references/scenarios/purchase-with-skill-pay.md
Create Knowledge Planet WeChat orders / handle payment challenges and security recovery → references/wechat-order-create.md
Query prices for joining, gift cards, renewals, light reading, or Planet invite codes → references/wechat-order-create.md#下单前查询价格
Call the underlying API directly / explore unwrapped capabilities → references/cli-exploration.md
Assemble Knowledge Planet share links → references/share-links.md
Understand security rules (write/delete confirmation) → Security rules
List the Planets I've joined / get group_id → references/group-list.md
Edit Planet name / description / background image / highlight image → references/group-settings.md
Browse the latest topics in a Planet → references/group-topics.md
View Planet tags → references/group-hashtags.md
Search content within a Planet → references/topic-search.md
View post details → references/topic-detail.md
Post (normal / poll / question / markdown / AI declaration) → references/topic-create.md
Edit post → references/topic-edit.md
Comment / nested reply → references/topic-reply.md
Answer a question (immediately / scheduled / silently) → references/topic-answer.md
Delete topic → references/topic-delete.md
Schedule topic publishing / modify or cancel scheduled task → references/topic-schedule.md
View pending scheduled tasks and quotas → references/topic-scheduled.md
Set as featured / pinned (owner) → references/topic-set.md
Unfeature (underlying interface api call) → references/topic-digest.md
Set tags for a topic → references/topic-tags.md
Read / set the column a topic belongs to (collect into column) → references/topic-attached-columns.md
View your own user info → references/user-info.md
View posts you've made (across Planets) → references/user-footprints.md
Submit NPS feedback → references/user-nps.md
Create/view/edit/delete notes → references/note-create.md , etc.
What items need confirmation before writing → Corresponds to the reference's > [!CAUTION] block + Security rules

Resource relationships

User (user_id) — 已登录账户
│
├── Group (group_id) — 星球/社群
│   ├── Topic (topic_id) — talk / q&a / task / solution
│   │   ├── Comment (comment_id)
│   │   │   └── 楼中楼 Reply (replied_comment_id)
│   │   ├── Answer — q&a 类型专属
│   │   └── Hashtag 标签
│   ├── Scheduled Job (job_id) — 定时发布主题/回答,每星球上限 10
│   └── Hashtag (hashtag_id)
│       └── Topic 列表
│
└── Note (note_id) — 公开笔记,不属于任何星球

Core concepts

  • Planet (Group): the community unit of Knowledge Planet, uniquely identified by group_id(pure digits). A user can be the creator or a member.
  • Topic: the content unit within a Planet, types:talk(post),q&a(question),task(assignment),solution(assignment answer).
  • Note: a content unit independent of Planets,publicly visible, accessible to anyone with the link — not a private memo.
  • Comment: Replies under a topic, supports nested replies (replied_comment_id)。
  • Digested / Sticky: Those with management permissions (Star Owner / Admin / Partner) can set a topic as digested or sticky, changing how it is displayed within the planet.
  • Scheduled Job: A topic or answer can be scheduled to publish automatically at a future point in time (within a 14-day window), with a limit of 10 per planet.

Security Rules

  • Do not output or transmit authentication tokens — a token is a login credential; do not output it in plain text in the terminal, and do not share it with others
  • Before write/delete operations, you must confirm the user's intent(posting, editing, commenting, answering, scheduled publishing, setting digested/sticky, modifying planet profile, creating notes, deleting topics or notes, canceling scheduled jobs, submitting NPS feedback, etc.)
  • Skill Pay is only supported on WorkBuddy and the host must provide the official weixinpay_pay; if any condition is not met, you must state that it is not supported and stop before creating an order, and must not call call_zsxq_api to create an order
  • Before creating an order, you must query or calculate the price according to the atomic reference, and confirm the type, object, and actual amount payable; fixed prices must not be rewritten by the user, and payment must be authorized by the user personally;PAYMENT_REQUIRED even if it returns success: false it only means pending payment, not failure or successful payment; automatically retrying order creation is prohibited
  • When unsure about group_id / topic_id / comment_id / note_id , first use a query command to confirm, then perform the write or delete
  • Notes are public content, accessible to anyone with the link — do not write privacy-related or sensitive information into notes
  • api raw writes must not bypass the security constraints of atomic operations; write interfaces discovered in exploration mode also require user confirmation
  • The > [!CAUTION] block of each write/delete reference lists the confirmation items specific to that operation
  • Once a channel is selected, use it consistently and do not mix channels; the MCP channel must not fabricate method/path values not documented in the reference or endpoint-catalog

Scenarios

Scenarios express business goals and are orchestrated from multiple atomic operations. SKILL.md only links to scenario entry points; for process details, see the entry documents.

Scenario Trigger phrase Entry
Daily patrol "Daily patrol / inspect the planet" "See what needs to be handled today" scenarios/daily-patrol.md
Comment section operations "Organize comment section questions for me to reply to" "Find unanswered comments and draft replies" scenarios/triage-comments.md
Question management "Find questions others asked me that I haven't answered yet" "Organize pending questions by priority" scenarios/manage-inbound-questions.md
Digest and tag organization "Organize recent topics, digest what should be digested and tag what should be tagged" "Which posts are worth setting as digested" scenarios/curate-digest-and-tags.md
Operations daily report / weekly report / retrospective "Make today's operations daily report" "Make this week's operations weekly report" "Review the past 7 days of operations" scenarios/compose-operations-report.md
Generate planet daily report poster "Generate a planet daily report poster / make a daily report image" "Turn recent content into a poster and send it to the group" scenarios/generate-daily-poster.md
Generate vertical animated video "Help me turn this post into a video" "Find recent posts suitable for making videos" "Generate this week's video" "Turn planet content into a video" scenarios/generate-video.md
Negative content monitoring "Patrol / monitor risky content in the planet" "Check for abuse / ads / complaints every hour" scenarios/monitor-risky-content.md
Automatic tagging "Batch-tag recent topics with given tags" "Batch re-tag historical content" scenarios/batch-tag-topics.md
Expiring member renewal care "Check members about to expire" "Do renewal care / renewal reminders" "Write scripts for expiring members based on activity level" scenarios/care-expiring-members.md
Include topics in columns "Include the latest N topics into column XX" "Batch-archive topics into columns / organize topic collections" scenarios/archive-topics-to-column.md
Migrate legacy skill "Check/clean up/migrate legacy Knowledge Planet skill" "Upgrade zsxq skill" scenarios/migrate-legacy-skills.md
Skill Pay purchase "Join or renew with Skill Pay / WeChat Pay" "Buy gift cards / light reading" "Paid questions / tips" scenarios/purchase-with-skill-pay.md
Answer product documentation questions "How do I get a refund for the planet / how long does a refund take" "How much is the fee / what is the rate" "How do I issue an invoice / what materials are needed for enterprise verification" "Why did the review fail / rules for violation bans" scenarios/answer-product-docs.md

Skill Pay

When handling Skill Pay purchase intent, read the purchase scenario for orchestration; the parameters and error semantics for creating orders, prices, payment authorization, and secure recovery are governed only by the atomic reference.

Planet management (group)

Shortcut Description Reference
zsxq-cli group +list List joined/created planets and get group_id group-list.md
zsxq-cli group +topics Browse the latest topics in a planet (paged) group-topics.md
zsxq-cli group +hashtags List planet tags and topic counts group-hashtags.md
zsxq-cli group +settings Modify planet name / description / background image / highlight image ⚠️ group-settings.md

API(zsxq-cli api call):

Tool Parameter Description
search_groups keyword Search planets by keyword
search_group_members group_id, keyword, limit Search planet members
get_hashtag_topics hashtag_id, limit, end_time List topics under a tag (paged)

Raw HTTP call:

Operation Command template Reference
Member list api raw --method GET --path /v2/groups/<group_id>/members --query '<json>' group-members.md
Column list api raw --method GET --path /v2/groups/<group_id>/columns group-columns.md
Create column api raw --method POST --path /v2/groups/<group_id>/columns --body '{"name":"…"}' ⚠️ group-column-create.md

The member list's expired_time is visible only to owners/admins of paid planets. A topic's column affiliation is a topic-dimension operation, seeTopic managementfor the raw HTTP call.

Counterexamples (do not do)

❌ Do not do ✅ Should do
When finding content by keyword, use +topics to page through and manually filter item by item Use topic +search full-text search
When checking "what I recently posted," run +topics Use user +footprints to get cross-planet footprints in one go
When the user only gives the planet name, ask the user to provide the group_id themselves First use group +list or search_groups to find the ID, then continue
When the name matches multiple similar planets, default to the first one List candidates (group_id + name) for the user to confirm
Treat search_group_members as a member list interface and increase limit to iterate over all members It is a keyword search, used only to locate a specific member by nickname

Topic management (topic)

Shortcut Description Reference
zsxq-cli topic +search Full-text search for topics within a planet topic-search.md
zsxq-cli topic +detail Get full topic details topic-detail.md
zsxq-cli topic +create Publish a new post (talk / q&a, poll, AI statement, markdown) ⚠️ topic-create.md
zsxq-cli topic +edit Edit your own post (body / attachments / AI statement / poll) ⚠️ topic-edit.md
zsxq-cli topic +reply Comment / nested reply ⚠️ topic-reply.md
zsxq-cli topic +answer Answer a question (supports scheduled / silent) ⚠️ topic-answer.md
zsxq-cli topic +set Set featured / pinned ⚠️ topic-set.md
zsxq-cli topic +schedule Schedule topic publishing (create / modify) ⚠️ topic-schedule.md
zsxq-cli topic +scheduled View pending scheduled tasks and quota topic-scheduled.md
zsxq-cli topic +unschedule Cancel a scheduled task ⚠️ topic-unschedule.md

⚠️ = write operation; you must confirm the content with the user before executing.

API(zsxq-cli api call):

Tool Parameter Description Reference
get_topic_comments topic_id, limit, index Get the topic's comment list (paginated) —
set_topic_digested topic_id, digested Set/unset featured (planet owner permission) ⚠️ topic-digest.md
set_topic_tags topic_id, titles Set tags for a topic (titles is the complete set of tags) ⚠️ topic-tags.md
get_self_question_topics topic_filter, count, end_time View questions you have initiated —
get_self_answer_topics topic_filter(unanswered/answered), count, end_time View questions others have initiated to me (account-level, returned items include the group field, must be filtered by planet) —

⚠️ = write operation (set_topic_digested / set_topic_tags will modify planet content); you must confirm with the user before executing, and comply with thesafety rulesand the corresponding reference's > [!CAUTION] block.

Raw HTTP call:

Operation Command template Reference
Delete topic api raw --method DELETE --path /v2/topics/<topic_id> ⚠️ topic-delete.md
Read the column a topic belongs to api raw --method GET --path /v2/topics/<topic_id>/attached_columns topic-attached-columns.md
Set the column a topic belongs to api raw --method POST --path /v2/topics/<topic_id>/attached_columns --body '{"column_ids":[...]}' ⚠️ topic-attached-columns.md

⚠️ = write operation; you must confirm with the user before executing. Setting the column a topic belongs to is afull replacement:column_ids and will overwrite the topic's original column membership; to "add to a column" you must first read the existing set and then merge it back, see topic-attached-columns.md。

User information (user)

Shortcut Description Reference
zsxq-cli user +info View the current user's profile (user_id, nickname, etc.) user-info.md
zsxq-cli user +footprints View cross-planet posting footprint user-footprints.md
zsxq-cli user +nps Submit NPS feedback ⚠️ user-nps.md

When a user expresses product dissatisfaction during use, discovers a missing platform capability, or is frustrated by multiple retries, after completing the main task you may incidentally prompt them to submit NPS feedback; for trigger details see user-nps.md。

Note management (note)

Notes arepublic content, anyone with the link can access them — do not write privacy-related or sensitive information into notes.

Shortcut Description Reference
zsxq-cli note +create Create a public note ⚠️ note-create.md
zsxq-cli note +list View the note list note-list.md
zsxq-cli note +detail View note details note-detail.md
zsxq-cli note +edit Edit a note ⚠️ note-edit.md
zsxq-cli note +delete Delete a note (irrecoverable) ⚠️ note-delete.md