u-foo 1.9.1 → 1.9.2
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
|
|
|
@@ -102,15 +102,17 @@ If pending events exist, show:
|
|
|
102
102
|
```
|
|
103
103
|
=== Pending Messages ===
|
|
104
104
|
|
|
105
|
-
|
|
106
|
-
Type:
|
|
107
|
-
Content: {"
|
|
105
|
+
[ufoo]<from:claude-code:abc123(architect)>
|
|
106
|
+
Type: message/targeted/message
|
|
107
|
+
Content: {"message":"review src/main.ts","injection_mode":"immediate"}
|
|
108
108
|
|
|
109
109
|
---
|
|
110
110
|
Please handle the above messages, after completion you can reply:
|
|
111
|
-
ufoo bus send "
|
|
111
|
+
ufoo bus send "architect" "Review completed, found 2 issues..."
|
|
112
112
|
```
|
|
113
113
|
|
|
114
|
+
Note: Messages use `[ufoo]<from:id(nickname)>` prefix to distinguish from manual user input.
|
|
115
|
+
|
|
114
116
|
### 5. IMPORTANT: Acknowledge messages after handling
|
|
115
117
|
|
|
116
118
|
After you have read and processed the messages, you MUST acknowledge them to prevent repeated notifications:
|
|
@@ -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)
|