zsxq-topic

Original：🇨🇳 Chinese
Translated

Knowledge Planet Topic Management: Search topics, view details, publish posts, post comments, answer questions, set featured topics and tags. Used when users need to find content, post, comment, answer questions, or manage topics.

34installs
Sourceunnoo/zsxq-skill
Added on

NPX Install

npx skill4agent add unnoo/zsxq-skill zsxq-topic

Tags

Translated version includes tags in frontmatter
zsxq-clitopic-managementcontent-moderationplanet-toolapi-integration

SKILL.md Content (Chinese)

View Translation Comparison →

topic (v1)

CRITICAL — MUST use the Read tool to read 
../zsxq-shared/SKILL.md
 before starting, which contains authentication and error handling rules.

Core Concepts

  • Topic: Content unit within the Planet, uniquely identified by 
    topic_id
    . Types: 
    • talk
      : Regular post (images and text)
    • q&a
      : Question, can be answered by the Planet Owner
    • article
      : Long article
  • Comment: Reply under a topic, identified by 
    comment_id
    , supports nested replies (
    replied_comment_id
    ).
  • Digested: The Planet Owner can mark high-quality topics as digested for prominent display within the Planet.

Resource Relationships

Group (group_id)
└── Topic (topic_id) — talk / q&a / article
    ├── Comment (comment_id)
    │   └── 楼中楼 Reply (replied_comment_id)
    ├── Answer（q&a 类型专属）
    └── Hashtag 标签列表

Important Notes

Must Confirm Before Write Operations

Posting, commenting, and answering are irreversible public operations. Must confirm with the user before execution:
  1. Target Planet / Topic (group_id / topic_id)
  2. Content to publish (title / content / text)

Obtaining topic_id

When unsure of the topic_id, query first before proceeding:
  • Keyword search: 
    topic +search --group-id xxx --query "keywords"
  • Browse latest: 
    group +topics --group-id xxx
  • View details: 
    topic +detail --topic-id xxx

Shortcuts (Recommended for Priority Use)

Shortcuts are advanced encapsulations of common operations (
zsxq-cli topic +<verb> [flags]
). Prioritize using operations with Shortcuts.
ShortcutDescription
+search
Full-text search for topics within the Planet, returns a table of topic_id / type / title / time
+detail
Get complete details of a single topic (content, comment count, like count, tags, etc.)
+create
Publish a new topic (post) in the specified Planet, execute after confirming content
+reply
Post a comment on a topic, supports nested replies, execute after confirming content
+answer
Publish an official answer to a q&a type topic, execute after confirming content

API (Directly Called via 
zsxq-cli api call
)

Advanced operations not covered by Shortcuts:
ToolParametersDescription
get_topic_comments
topic_id
, 
limit
, 
index
Get topic comment list (pagination)
set_topic_digested
topic_id
, 
digested
Set/cancel digested status (Planet Owner permission)
set_topic_tags
topic_id
, 
titles
Set tags for a topic (array of tag names)
get_self_question_topics
topic_filter
, 
count
, 
end_time
View questions initiated by yourself (
unanswered
/
answered
)