feat(skills): add paseo chat coordination

2026-03-24 12:37:13 +07:00
parent af8509d012
commit fa0346921a
3 changed files with 625 additions and 0 deletions
@@ -0,0 +1,133 @@
+---
+name: paseo-chat
+description: Use chat rooms through a chat helper. Use when the user says "chat room", "room", "coordinate through chat", "shared mailbox", or wants agents to communicate asynchronously.
+user-invocable: true
+---
+
+# Paseo Chat Skill
+
+This skill teaches how to use chat.
+
+Use `skills/paseo-chat/bin/chat.sh`.
+
+**User's arguments:** $ARGUMENTS
+
+---
+
+## Prerequisites
+
+Load the **Paseo skill** first if you need CLI guidance for launching or messaging agents.
+
+## Rules
+
+When using chat:
+- create a room with `chat.sh room create` if you need a new room
+- inspect available rooms with `chat.sh room list` and `chat.sh room show`
+- post with `chat.sh post`
+- read with `chat.sh read`
+- keep reads bounded, usually `--limit 10` or `--limit 20`
+- check chat often while working
+
+Do not read or write the backing files directly. Use `chat.sh`.
+
+Mentions and replies are active:
+- if you post `@agent-id` in a message, chat will notify that agent immediately
+- if you use `--reply-to`, chat will notify the author of the replied-to message immediately
+- notifications are sent with `paseo send --no-wait`
+
+## Command Surface
+
+### Create a room
+
+```bash
+skills/paseo-chat/bin/chat.sh room create \
+  --room issue-456 \
+  --title "Issue 456 coordination" \
+  --purpose "Coordinate implementation and review"
+```
+
+### List rooms
+
+```bash
+skills/paseo-chat/bin/chat.sh room list
+```
+
+### Show room details
+
+```bash
+skills/paseo-chat/bin/chat.sh room show --room issue-456
+```
+
+### Post a message
+
+```bash
+skills/paseo-chat/bin/chat.sh post \
+  --room issue-456 \
+  --body "I traced the failure to relay auth. Investigating config loading now."
+```
+
+Author defaults:
+- `--agent-id` if provided
+- otherwise `$PASEO_AGENT_ID`
+- otherwise `manual`
+
+Optional reply:
+
+```bash
+skills/paseo-chat/bin/chat.sh post \
+  --room issue-456 \
+  --reply-to msg-001 \
+  --body "I can take that next."
+```
+
+Direct mention:
+
+```bash
+skills/paseo-chat/bin/chat.sh post \
+  --room issue-456 \
+  --body "@agent-beta can you verify the relay path next?"
+```
+
+### Read recent messages
+
+```bash
+skills/paseo-chat/bin/chat.sh read --room issue-456 --limit 10
+```
+
+### Filter reads
+
+```bash
+skills/paseo-chat/bin/chat.sh read --room issue-456 --agent-id 123abc
+skills/paseo-chat/bin/chat.sh read --room issue-456 --since 2026-03-24T10:00:00Z
+```
+
+## Defaults
+
+When creating a room:
+- choose a short explicit room id
+- prefer slugs like `issue-456`, `pr-143-review`, `feature/relay-cleanup`
+- give the room a clear title and purpose
+
+When using a room:
+- read only a bounded window before acting
+- post updates when they would help another agent or your future self
+- use `--reply-to` when responding to a specific message
+- use `@agent-id` when you want to get a specific agent's attention
+- check chat frequently enough that shared coordination actually works
+
+Typical things to post:
+- status updates
+- blockers
+- handoffs
+- review findings
+- important context and memories another agent may need later
+
+## Your Job
+
+1. Understand whether you should use an existing room or create a new one
+2. Choose a room id and title
+3. Create the room with `chat.sh room create` if needed
+4. Read the room with bounded history
+5. Post clearly
+6. Use `--reply-to` when replying to a specific message
+7. Use `@agent-id` when you want to notify someone directly