bluesky

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Bluesky

Overview

概述

Post content to the Bluesky social network using the

bsky

terminal application. This skill enables creating text posts, sharing images and videos with alt text, replying to posts, and quoting posts.

使用

bsky

终端应用在Bluesky社交网络发布内容。本技能支持创建文字帖子、分享带替代文本的图片和视频、回复帖子以及引用帖子。

When to Use This Skill

何时使用本技能

Use this skill in these scenarios:

Explicitly requested - When directly asked to post something to Bluesky
Proactive sharing - When working in public repositories and encountering:
- Completed features or significant milestones worth announcing
- Interesting technical insights or discoveries
- Major achievements or project releases
- Community-relevant updates or announcements

Important: Only suggest posting proactively when in public repositories. Never suggest posting for private or internal work.

在以下场景中使用本技能：

明确要求时 - 当直接被要求在Bluesky上发布内容时
主动分享时 - 当在公共代码仓库工作时，遇到以下情况：
- 已完成的功能或值得宣布的重要里程碑
- 有趣的技术见解或发现
- 重大成果或项目发布
- 与社区相关的更新或公告

重要提示： 仅在公共代码仓库中主动建议发布内容。切勿针对私有或内部工作建议发布内容。

Core Capabilities

核心功能

1. Text Posts

1. 文字帖子

Create simple text posts using the

bsky post

command:

bash

bsky post "Your message here"

For longer or multi-line posts, use stdin:

bash

echo "Your longer message
with multiple lines" | bsky post --stdin

Best practices:

Keep posts concise and engaging
Use proper formatting and line breaks for readability
Consider adding relevant hashtags at the end
URLs must include the
https://
protocol prefix -- bare domains like
```
www.example.com/path
```
will NOT be rendered as clickable links. Always use
```
https://www.example.com/path
```

使用

bsky post

命令创建简单的文字帖子：

bash

bsky post "Your message here"

对于较长或多行的帖子，使用标准输入（stdin）：

bash

echo "Your longer message
with multiple lines" | bsky post --stdin

最佳实践：

帖子应简洁且有吸引力
使用适当的格式和换行以提升可读性
考虑在末尾添加相关话题标签
URL必须包含
https://
协议前缀 -- 像
```
www.example.com/path
```
这样的裸域名不会被渲染为可点击链接。请始终使用
```
https://www.example.com/path
```

2. Posts with Images

2. 带图片的帖子

Include images in posts using the

--image

-i

flag:

bash

bsky post "Check out this screenshot!" --image /path/to/image.png

Multiple images:

bash

bsky post "Here are several images" \
  --image image1.png \
  --image image2.png \
  --image image3.png

Add alt text for accessibility:

bash

bsky post "New feature screenshot" \
  --image screenshot.png \
  --image-alt "Dashboard showing user analytics with graphs"

Best practices:

Always provide alt text using
```
--image-alt
```
for accessibility
Alt text should be descriptive and concise
Match the order of
```
--image-alt
```
flags to
```
--image
```
flags

使用

--image

或

-i

标记在帖子中添加图片：

bash

bsky post "Check out this screenshot!" --image /path/to/image.png

多张图片：

bash

bsky post "Here are several images" \
  --image image1.png \
  --image image2.png \
  --image image3.png

添加替代文本以提升可访问性：

bash

bsky post "New feature screenshot" \
  --image screenshot.png \
  --image-alt "Dashboard showing user analytics with graphs"

最佳实践：

始终使用
```
--image-alt
```
提供替代文本以提升可访问性
替代文本应描述性强且简洁
```
--image-alt
```
标记的顺序需与
```
--image
```
标记的顺序匹配

3. Posts with Video

3. 带视频的帖子

Share video content using the

--video

-v

flag:

bash

bsky post "Demo of the new feature" --video demo.mp4

With alt text:

bash

bsky post "Feature demo" \
  --video demo.mp4 \
  --video-alt "Screen recording showing the login flow with OAuth"

使用

--video

或

-v

标记分享视频内容：

bash

bsky post "Demo of the new feature" --video demo.mp4

带替代文本：

bash

bsky post "Feature demo" \
  --video demo.mp4 \
  --video-alt "Screen recording showing the login flow with OAuth"

4. Replying to Posts

4. 回复帖子

Reply to existing posts using the

-r

flag with the AT protocol URI.

Important: The

-r

flag does NOT work when passing text as a positional argument -- the CLI treats it as part of the post text. Always use

--stdin

when replying. Also,

-r

requires an AT protocol URI (

at://...

), not a Bluesky web URL.

bash

echo "Thanks for sharing!" | bsky post --stdin -r "at://did:plc:xyz/app.bsky.feed.post/abc123"

使用

-r

标记搭配AT protocol URI回复现有帖子。

重要提示： 当将文本作为位置参数传递时，

-r

标记无法正常工作——CLI会将其视为帖子文本的一部分。回复时请始终使用

--stdin

。此外，

-r

需要AT protocol URI（

at://...

），而非Bluesky网页URL。

bash

echo "Thanks for sharing!" | bsky post --stdin -r "at://did:plc:xyz/app.bsky.feed.post/abc123"

5. Quote Posts

5. 引用帖子

Quote an existing post using the

-q

flag:

bash

bsky post "Great point about Go modules!" -q at://did:plc:xyz/app.bsky.feed.post/abc123

使用

-q

标记引用现有帖子：

bash

bsky post "Great point about Go modules!" -q at://did:plc:xyz/app.bsky.feed.post/abc123

Workflow Guidelines

工作流程指南

When creating a post:

Determine the content type - Text only, with images, with video, reply, or quote
Prepare the message - Craft clear, concise text that provides context
Prepare media if applicable - Ensure images/videos are accessible and write descriptive alt text
Construct the command - Use appropriate flags based on content type
Execute the post - Run the
```
bsky post
```
command
Verify success - Check command output for confirmation

创建帖子时：

确定内容类型 - 仅文字、带图片、带视频、回复或引用
准备消息 - 撰写清晰、简洁的文本以提供上下文
准备媒体（如适用） - 确保图片/视频可访问，并撰写描述性的替代文本
构建命令 - 根据内容类型使用相应的标记
执行发布 - 运行
```
bsky post
```
命令
验证成功 - 检查命令输出以确认发布成功

Content Guidelines

内容指南

When suggesting or creating posts:

Be authentic - Share genuine insights and achievements
Provide value - Ensure the post offers something useful to the community
Include context - Don't assume everyone has background knowledge
Be professional - Maintain appropriate tone for technical social media
Respect privacy - Never share sensitive information or private repository details
Consider timing - Only suggest sharing when the work is meaningful enough to warrant it

当建议或创建帖子时：

保持真实 - 分享真实的见解和成果
提供价值 - 确保帖子为社区提供有用的内容
包含上下文 - 不要假设所有人都具备背景知识
保持专业 - 维持技术社交媒体的恰当语气
尊重隐私 - 切勿分享敏感信息或私有仓库细节
考虑时机 - 仅当工作内容足够有意义时才建议分享

Example Scenarios

示例场景

Scenario 1: Announcing a New Feature

场景1：宣布新功能

bash

bsky post "Just shipped a new feature in my Go library: automatic retry logic with exponential backoff!

Makes handling transient failures much easier. Check it out: https://github.com/user/repo" \
  --image feature-screenshot.png \
  --image-alt "Code snippet showing the new retry configuration API"

bash

bsky post "Just shipped a new feature in my Go library: automatic retry logic with exponential backoff!

Makes handling transient failures much easier. Check it out: https://github.com/user/repo" \
  --image feature-screenshot.png \
  --image-alt "Code snippet showing the new retry configuration API"

Scenario 2: Sharing a Technical Insight

场景2：分享技术见解

bash

echo "TIL: Go's io.Pipe() is incredibly useful for streaming data between goroutines without buffering.

Perfect for processing large files without loading everything into memory.

Example use case: streaming CSV parsing → transformation → JSON encoding" | bsky post --stdin

bash

echo "TIL: Go's io.Pipe() is incredibly useful for streaming data between goroutines without buffering.

Perfect for processing large files without loading everything into memory.

Example use case: streaming CSV parsing → transformation → JSON encoding" | bsky post --stdin

Scenario 3: Project Milestone

场景3：项目里程碑

bash

bsky post "Just reached 1,000 stars on my open source project!

Thanks to everyone in the community for the support and contributions. This wouldn't be possible without you!" \
  --image milestone-screenshot.png \
  --image-alt "GitHub repository page showing 1,000 stars"

bash

bsky post "Just reached 1,000 stars on my open source project!

Thanks to everyone in the community for the support and contributions. This wouldn't be possible without you!" \
  --image milestone-screenshot.png \
  --image-alt "GitHub repository page showing 1,000 stars"

Scenario 4: Replying to Feedback

场景4：回复反馈

When someone shares or comments on your work, reply directly:

bash

echo "Thanks for the detailed feedback! I've opened an issue to track this enhancement." \
  | bsky post --stdin -r "at://did:plc:xyz/app.bsky.feed.post/abc123"

当有人分享或评论你的工作时，直接回复：

bash

echo "Thanks for the detailed feedback! I've opened an issue to track this enhancement." \
  | bsky post --stdin -r "at://did:plc:xyz/app.bsky.feed.post/abc123"

Notes

注意事项

The
```
bsky
```
command uses your authenticated session from previous login
If not logged in, run
```
bsky login
```
first
Post URIs can be found from other
```
bsky
```
commands like
```
bsky timeline
```
or from the Bluesky web interface
Multiple images/alt texts are supported by repeating the flags
Images and videos should be local file paths accessible to the command

```
bsky
```
命令会使用你之前登录时的已认证会话
若未登录，请先运行
```
bsky login
```
帖子URI可通过其他
```
bsky
```
命令（如
```
bsky timeline
```
）或Bluesky网页界面找到
重复使用标记可支持多张图片/多个替代文本
图片和视频应为命令可访问的本地文件路径