Zsxq Note
Publish user-approved public notes (and optional images) to 知识星球 with zsxq-cli, including create, detail check, edit, and irreversible delete flows.
Overview
zsxq-note is an agent skill for the Launch phase that creates, verifies, edits, and deletes public 知识星球 notes through zsxq-cli after explicit user confirmation.
Install
npx skills add https://github.com/unnoo/zsxq-skill --skill zsxq-noteWhat is this skill?
- `note +create` with required `--text`, optional comma-separated image `--files`, and `--json` returning note_id
- Mandatory user confirmation before any write—notes are public, not private memos
- Atomic rollback on failed creates so no orphan or half-written note_id
- `note +delete` is destructive and non-recoverable with explicit confirm step
- Recommended verify step: `note +detail --note-id` immediately after create
- Create failures roll back atomically with no partial note_id
- Delete is permanent with no recovery
Adoption & trust: 2.3k installs on skills.sh; 157 GitHub stars; 2/3 security scanners passed (skills.sh audits).
What problem does it solve?
You want your agent to post to 知识星球 without accidentally publishing private drafts or leaving broken half-created notes when the API fails.
Who is it for?
Solo creators shipping public updates or teasers on 知识星球 who already use zsxq-cli and want guarded agent execution.
Skip if: Private notebooks, audiences outside ZS XQ, or unattended bulk posting without human review of public text.
When should I use this skill?
User asks to create, verify, edit, or delete 知识星球 notes via zsxq-cli shortcuts and content is intended to be public.
What do I get? / Deliverables
After user-approved text (and optional images), the agent runs documented zsxq-cli note commands, returns note_id from JSON output, and can confirm or permanently delete with documented rollback on create failure.
- Published ZS XQ note with note_id and create_time from JSON
- Optional post-create detail verification output
Recommended Skills
Journey fit
ZS XQ notes are outward-facing community assets—canonical placement is Launch distribution, not private ideation or internal PM. Distribution matches posting linkable public notes anyone can open, distinct from in-circle topics or landing pages.
How it compares
Community note CLI with explicit publish gates—not a generic Markdown publisher or email newsletter skill.
Common Questions / FAQ
Who is zsxq-note for?
Indie builders and operators publishing on 知识星球 who want agents to run zsxq-cli note commands only after confirming public-safe copy and attachments.
When should I use zsxq-note?
Use it at Launch when distributing linkable notes to your planet, and in Grow when recycling confirmed snippets into community-visible updates—not for secret drafts.
Is zsxq-note safe to install?
Writes are irreversible on delete and notes are public; authenticate via your zsxq setup and review the Security Audits panel on this page before granting network/API access to an agent.
SKILL.md
READMESKILL.md - Zsxq Note
# note +create（创建笔记） 本 skill 对应 shortcut：`zsxq-cli note +create`。 在知识星球创建一条公开笔记，支持文本和图片附件。任何人通过笔记链接均可访问。 > [!CAUTION] > 这是**写入操作**，且笔记是**公开内容** —— 不要把它当作私密备忘录使用。执行前必须向用户确认： > 1. 笔记内容（text） > 2. 附件列表（如有） ## 命令 ```bash # 创建一条笔记 zsxq-cli note +create --text "示例笔记内容" # 多行内容（使用 \n 换行） zsxq-cli note +create --text "示例笔记第一行\n示例笔记第二行" # JSON 格式输出（含新建 note_id） zsxq-cli note +create --text "示例笔记内容" --json # 带图片的笔记 zsxq-cli note +create --text "记录" --files idea.jpg ``` ## 参数 | 参数 | 必填 | 说明 | |------|------|------| | `--text <text>` | **是** | 笔记内容 | | `--files <paths>` | 否 | 附件路径，多个用逗号分隔（仅图片） | | `--json` | 否 | 输出原始 JSON（含 note_id、create_time） | ## 输出 ``` ✓ Note created { "note_id": "444555666777", "create_time": "2026-04-01T15:45:31.007+0800", "text": "示例笔记内容" } ``` ## 推荐工作流 ```bash # 第一步：与用户确认笔记内容（公开可访问，避免写入隐私） # 第二步：执行创建 zsxq-cli note +create --text "笔记内容" # 第三步：（可选）拿到 note_id 后立即查看，确认内容正确 zsxq-cli note +detail --note-id <新建的 note_id> ``` ## 失败语义 写入失败即原子回滚 —— 不会留下空笔记或半成品 note_id。重试前请先确认参数是否合法。 ## 错误说明 通用错误（401 等）见 [zsxq-shared](../../zsxq-shared/SKILL.md#常见错误处理)。本命令无特有错误。 ## 参考 - [zsxq-note-edit](zsxq-note-edit.md) — 编辑笔记 - [zsxq-note-delete](zsxq-note-delete.md) — 删除笔记 - [zsxq-topic-create](../../zsxq-topic/references/zsxq-topic-create.md) — 在星球内发布主题（帖子） - [zsxq-shared](../../zsxq-shared/SKILL.md) # note +delete（删除笔记） 本 skill 对应 shortcut：`zsxq-cli note +delete`。 删除指定笔记。删除后**不可恢复**。 > [!CAUTION] > 这是**不可逆的破坏性操作** —— 删除后笔记将永久消失，无法恢复。执行前必须向用户确认： > 1. 目标笔记（note_id）及其内容 > 2. 明确用户确实要删除 ## 命令 ```bash # 删除笔记 zsxq-cli note +delete --note-id 444555666777 ``` ## 参数 | 参数 | 必填 | 说明 | |------|------|------| | `--note-id <id>` | **是** | 笔记 ID（从 `note +list` 获取） | ## 推荐工作流 ```bash # 第一步：确认笔记内容 zsxq-cli note +detail --note-id 444555666777 # 第二步：向用户确认后执行删除 zsxq-cli note +delete --note-id 444555666777 ``` ## 失败语义 删除失败即原子回滚 —— 笔记保持原状不会被部分删除。 ## 错误说明 通用错误（401、`--note-id is required`、笔记不存在、无权限等）见 [zsxq-shared](../../zsxq-shared/SKILL.md#常见错误处理)。本命令无特有错误。 ## 参考 - [zsxq-note-detail](zsxq-note-detail.md) — 删除前确认笔记内容 - [zsxq-note-list](zsxq-note-list.md) — 查看笔记列表获取 note_id - [zsxq-shared](../../zsxq-shared/SKILL.md) # note +detail（查看笔记详情） 本 skill 对应 shortcut：`zsxq-cli note +detail`。 获取单条笔记的完整详情，包括内容正文、创建时间等。 ## 命令 ```bash # 查看笔记详情 zsxq-cli note +detail --note-id 444555666777 # JSON 格式输出 zsxq-cli note +detail --note-id 444555666777 --json ``` ## 参数 | 参数 | 必填 | 说明 | |------|------|------| | `--note-id <id>` | **是** | 笔记 ID（从 `note +list` 获取） | | `--json` | 否 | 输出原始 JSON | ## 输出字段说明 ```json { "note": { "note_id": "444555666777", "text": "笔记正文…", "create_time": "2026-04-10T09:00:00.000+0800" } } ``` 完整字段以 `--json` 实际输出为准。 ## 错误说明 通用错误（401、`--note-id is required`、笔记不存在等）见 [zsxq-shared](../../zsxq-shared/SKILL.md#常见错误处理)。本命令无特有错误。 ## 参考 - [zsxq-note-list](zsxq-note-list.md) — 查看笔记列表获取 note_id - [zsxq-note-edit](zsxq-note-edit.md) — 编辑笔记 - [zsxq-shared](../../zsxq-shared/SKILL.md) # note +edit（编辑笔记） 本 skill 对应 shortcut：`zsxq-cli note +edit`。 编辑已有笔记的内容。未修改的字段自动保留。 > [!CAUTION] > 这是**写入操作** —— 编辑后内容立即更新，原内容不可恢复。执行前必须向用户确认： > 1. 目标笔记（note_id）及其当前内容 > 2. 修改后的内容（含附件变更，如有） > [!IMPORTANT] > 只能编辑自己创建的笔记，无法编辑他人的笔记。 ## 命令 ```bash # 修改笔记内容 zsxq-cli note +edit --note-id 444555666777 --text "新的笔记内容" # JSON 格式输出 zsxq-cli note +edit --note-id 444555666777 --text "新的笔记内容" --json ``` ## 参数 | 参数 | 必填 | 说明 | |------|------|------| | `--note-id <id>` | **是** | 笔记 ID（从 `note +list` 获取） | | `--text <text>` | 否 | 新内容（不传则保留原内容） | | `--files <paths>` | 否 | 新附件，多个用逗号分隔（仅图片，替换原有附件） | | `--clear-files` | 否 | 清除所有附件 | | `--json` | 否 | 输出原始 JSON | ## 推荐工作流 ```bash # 第一步：确认当前笔记内容 zsxq-cli note +detail --note-id 444555666777 # 第二步：确认无误后执行编辑 zsxq-cli note +edit --note-id 444555666777 --text "新的笔记内容" ``` ## 失败语义 编辑失败即原子回滚 —— 原内容保留不变。重试前请先确认参数是否合法。 ## 错误说明 通用错误（401、`--note-id is required`、笔记不存在、403 无权限编辑他人笔记等）见 [zsxq-shared](../../zsxq-shared/SKILL.md#常见错误处理)。 ## 参考 - [zsxq-note-detail](zsxq-note-detail.md