@songsid/agend 2.1.0 → 2.1.1-beta.1
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.
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: tui-effort
|
|
3
|
+
description: 在 Kiro CLI TUI instance 中，透過 tmux 查看或設定模型的 reasoning effort
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Kiro TUI Effort
|
|
7
|
+
|
|
8
|
+
## 適用範圍
|
|
9
|
+
|
|
10
|
+
已在 Kiro CLI 2.14.2、AgEnD `kiro_ui: tui` 實測。
|
|
11
|
+
|
|
12
|
+
```yaml
|
|
13
|
+
instances:
|
|
14
|
+
my-kiro:
|
|
15
|
+
backend: kiro-cli
|
|
16
|
+
kiro_ui: tui
|
|
17
|
+
```
|
|
18
|
+
|
|
19
|
+
**kiro_ui 模式差異：**
|
|
20
|
+
- `kiro_ui: tui`：Kiro v2 TUI（預設推薦）；本 skill 適用。
|
|
21
|
+
- `kiro_ui: v3`：v3 unified agent harness；是不同的 agent engine，不只是換皮膚。session 格式與 v2 不相容，不能互 resume。若要使用 v3，需另外實測 `/effort` 行為。
|
|
22
|
+
- `kiro_ui: legacy`：舊 UI，互動行為不同，本 skill 不適用。
|
|
23
|
+
|
|
24
|
+
若修改 `kiro_ui`，先 reload 再 restart：
|
|
25
|
+
```bash
|
|
26
|
+
agend reload
|
|
27
|
+
# 然後用 AgEnD 的 restart_instance 工具重啟 instance
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
## 設定 effort（推薦方式）
|
|
31
|
+
|
|
32
|
+
直接傳 level 給 `/effort`，不要依賴 picker 游標位置：
|
|
33
|
+
|
|
34
|
+
```bash
|
|
35
|
+
INSTANCE='<instance-name>'
|
|
36
|
+
tmux send-keys -t "agend:${INSTANCE}" -l '/effort max'
|
|
37
|
+
tmux send-keys -t "agend:${INSTANCE}" Enter
|
|
38
|
+
sleep 1
|
|
39
|
+
tmux capture-pane -t "agend:${INSTANCE}" -p | tail -5
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
成功回應：
|
|
43
|
+
```
|
|
44
|
+
Effort set to max
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
等待輸入時，狀態列顯示目前 effort：
|
|
48
|
+
```
|
|
49
|
+
kiro_default · claude-sonnet-4.6 · Max · ◔ 10% · λ ...
|
|
50
|
+
```
|
|
51
|
+
|
|
52
|
+
**可用 level：** `low`、`medium`、`high`、`xhigh`、`max`
|
|
53
|
+
- 實際支援集合由目前 model 決定；不支援的 level 不出現在 picker
|
|
54
|
+
- 例：Claude Sonnet 4.6 支援 Low / Medium / High / Max（無 xhigh）
|
|
55
|
+
|
|
56
|
+
## 使用互動 picker（人工操作 / 除錯）
|
|
57
|
+
|
|
58
|
+
```bash
|
|
59
|
+
INSTANCE='<instance-name>'
|
|
60
|
+
tmux send-keys -t "agend:${INSTANCE}" -l '/effort'
|
|
61
|
+
tmux send-keys -t "agend:${INSTANCE}" Enter
|
|
62
|
+
sleep 1
|
|
63
|
+
tmux capture-pane -t "agend:${INSTANCE}" -p | tail -10
|
|
64
|
+
```
|
|
65
|
+
|
|
66
|
+
如需 tmux 自動導航，每個按鍵**分開送**並加短暫間隔：
|
|
67
|
+
|
|
68
|
+
```bash
|
|
69
|
+
tmux send-keys -t "agend:${INSTANCE}" Down; sleep 0.2
|
|
70
|
+
tmux send-keys -t "agend:${INSTANCE}" Down; sleep 0.2
|
|
71
|
+
tmux send-keys -t "agend:${INSTANCE}" Down; sleep 0.2
|
|
72
|
+
tmux send-keys -t "agend:${INSTANCE}" Enter
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
**不要假設固定次數 = 固定 level。** 游標初始在 Low，每次 Down 移一格；支援 `xhigh` 的 model 會多一個選項，所需次數不同。自動化一律用 `/effort <level>`。
|
|
76
|
+
|
|
77
|
+
## Effort 等級說明
|
|
78
|
+
|
|
79
|
+
| 等級 | 行為與適用場景 |
|
|
80
|
+
|------|--------------|
|
|
81
|
+
| Low | 回覆較快、較短；簡單查詢與快速確認 |
|
|
82
|
+
| Medium | 速度與推理深度平衡；一般開發任務 |
|
|
83
|
+
| High | 更完整的分析；複雜重構與架構決策 |
|
|
84
|
+
| XHigh | 延伸推理；多檔案改動（僅部分 model 支援） |
|
|
85
|
+
| Max | 最大推理深度；困難 debug、安全審查、高耦合問題 |
|
|
86
|
+
|
|
87
|
+
Effort 控制模型的 reasoning 深度（thinking tokens），較高 level 通常增加延遲與 credits 消耗。
|
|
88
|
+
|
|
89
|
+
## 持久化
|
|
90
|
+
|
|
91
|
+
Kiro CLI 2.6.0 起，`/effort` 設定**自動持久化**到 `~/.kiro/settings/cli.json`，**不需要每次 restart 後重設**。
|
|
92
|
+
|
|
93
|
+
若要用設定檔指定 per-model 預設：
|
|
94
|
+
```json
|
|
95
|
+
// ~/.kiro/settings/cli.json 或 .kiro/settings/cli.json
|
|
96
|
+
{
|
|
97
|
+
"chat.modelDefaults": {
|
|
98
|
+
"claude-sonnet-4.6": {
|
|
99
|
+
"output_config": {
|
|
100
|
+
"effort": "max"
|
|
101
|
+
}
|
|
102
|
+
}
|
|
103
|
+
}
|
|
104
|
+
}
|
|
105
|
+
```
|
|
106
|
+
|
|
107
|
+
優先序：session `/effort` > workspace `chat.modelDefaults` > user `chat.modelDefaults` > model 預設。
|
|
108
|
+
|
|
109
|
+
**注意：** 不要在 fleet.yaml 加 `model_reasoning_effort`，AgEnD 目前不會將此欄位傳給 kiro-cli。
|
|
110
|
+
|
|
111
|
+
## 注意事項
|
|
112
|
+
|
|
113
|
+
- 送指令前確認 instance 正在等待輸入（不在生成中）
|
|
114
|
+
- v3 是不同 engine，不要直接套用此 skill 的畫面假設
|
|
115
|
+
- 自動化一律用 `/effort <level>`，不要操作 picker
|