u-foo 1.9.1 → 1.9.3
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/SKILLS/ufoo/SKILL.md
CHANGED
|
@@ -24,14 +24,15 @@ When you see a probe marker command like `/ufoo <marker>` (Claude) or `$ufoo <ma
|
|
|
24
24
|
|
|
25
25
|
### When to Record
|
|
26
26
|
|
|
27
|
-
**"
|
|
27
|
+
**"Only record decisions that matter beyond this session."**
|
|
28
28
|
|
|
29
|
-
Record a decision
|
|
29
|
+
Record a decision for important, plan-level knowledge that other agents or your future self need. The threshold is HIGH — most tasks do NOT need a decision.
|
|
30
30
|
|
|
31
|
-
- **Always record**: architectural choices,
|
|
32
|
-
- **Also record**:
|
|
31
|
+
- **Always record**: architectural choices, plan-level decisions with multiple options, cross-agent coordination decisions, trade-off analysis where alternatives were considered and rejected
|
|
32
|
+
- **Also record**: design patterns that set precedent, integration contracts between systems, decisions that constrain future work
|
|
33
|
+
- **Do NOT record**: routine bug fixes, simple implementation details, trivial observations, findings that only matter within the current task
|
|
33
34
|
- **Write the decision BEFORE acting on it** — if your session dies, the knowledge survives
|
|
34
|
-
- **
|
|
35
|
+
- **Rule of thumb**: if another agent wouldn't need to know about it, don't write a decision
|
|
35
36
|
|
|
36
37
|
### Commands
|
|
37
38
|
|
|
@@ -121,7 +122,35 @@ Notes:
|
|
|
121
122
|
|
|
122
123
|
---
|
|
123
124
|
|
|
124
|
-
## 3.
|
|
125
|
+
## 3. Message Format
|
|
126
|
+
|
|
127
|
+
Bus messages use a unified prefix format to distinguish sources:
|
|
128
|
+
|
|
129
|
+
- `[ufoo]<from:id(nickname)>` — message from another agent via the bus
|
|
130
|
+
- `[manual]<to:id(nickname)>` — manual user input directed at an agent
|
|
131
|
+
|
|
132
|
+
When you see `[ufoo]<from:xxx>` in your prompt, it's an inter-agent message — `xxx` is the sender's ID and nickname.
|
|
133
|
+
When you see `[manual]<to:xxx>`, it's a direct user instruction to an agent — `xxx` is the recipient's ID and nickname.
|
|
134
|
+
|
|
135
|
+
---
|
|
136
|
+
|
|
137
|
+
## 4. Team Activity (Input History)
|
|
138
|
+
|
|
139
|
+
Your bootstrap prompt may include a `## Team Activity` section showing recent prompts sent to all agents. Use this to understand:
|
|
140
|
+
- What each agent is currently working on
|
|
141
|
+
- Who sent what tasks to whom
|
|
142
|
+
- The overall coordination flow
|
|
143
|
+
|
|
144
|
+
Commands:
|
|
145
|
+
```bash
|
|
146
|
+
ufoo history build # Rebuild timeline from bus + session data
|
|
147
|
+
ufoo history show [limit] # Show recent entries
|
|
148
|
+
ufoo history prompt [limit] # Render as injectable prompt block
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
---
|
|
152
|
+
|
|
153
|
+
## 5. Initialization (uinit)
|
|
125
154
|
|
|
126
155
|
Trigger: `/uinit` or `/ufoo init`
|
|
127
156
|
|
|
@@ -97,19 +97,18 @@ ufoo bus alert "$SUBSCRIBER" --stop
|
|
|
97
97
|
ufoo bus check "$SUBSCRIBER"
|
|
98
98
|
```
|
|
99
99
|
|
|
100
|
-
|
|
100
|
+
The system automatically prefixes each message with `[ufoo]<from:id(nickname)>` to identify the sender. You do not need to add this prefix yourself.
|
|
101
101
|
|
|
102
|
-
|
|
103
|
-
=== Pending Messages ===
|
|
104
|
-
|
|
105
|
-
@you from claude-code:abc123
|
|
106
|
-
Type: task/delegate
|
|
107
|
-
Content: {"task":"review","file":"src/main.ts"}
|
|
102
|
+
If pending events exist, output looks like:
|
|
108
103
|
|
|
109
|
-
---
|
|
110
|
-
Please handle the above messages, after completion you can reply:
|
|
111
|
-
ufoo bus send "claude-code:abc123" "Review completed, found 2 issues..."
|
|
112
104
|
```
|
|
105
|
+
[ufoo]<from:claude-code:abc123(architect)>
|
|
106
|
+
Type: message/targeted/message
|
|
107
|
+
Content: {"message":"review src/main.ts","injection_mode":"immediate"}
|
|
108
|
+
```
|
|
109
|
+
|
|
110
|
+
- The sender ID and nickname are in the `[ufoo]<from:...>` line — use the ID to reply
|
|
111
|
+
- The actual task is in `Content.message`
|
|
113
112
|
|
|
114
113
|
### 5. IMPORTANT: Acknowledge messages after handling
|
|
115
114
|
|
|
@@ -13,7 +13,8 @@ description: |
|
|
|
13
13
|
Fast context check for daily use. Run at session start or anytime.
|
|
14
14
|
|
|
15
15
|
Pre-flight reminder:
|
|
16
|
-
- If the user is asking for
|
|
16
|
+
- If the user is asking for an important architectural decision, a plan with multiple options, or a cross-agent coordination choice, write a decision before replying.
|
|
17
|
+
Do NOT write decisions for routine tasks, simple bug fixes, or trivial findings.
|
|
17
18
|
Use: `ufoo ctx decisions new "<Title>"`
|
|
18
19
|
|
|
19
20
|
## Decision format (canonical)
|