agentflowctl 0.1.1 → 0.1.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/README.md +12 -5
- package/examples/github-actions.yml +3 -5
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -10,13 +10,12 @@
|
|
|
10
10
|
|
|
11
11
|
## 快速開始
|
|
12
12
|
|
|
13
|
-
需要 Node.js 22 以上與 git
|
|
13
|
+
需要 Node.js 22 以上與 git。不需要全域安裝，直接用 `npx` 執行。先讓各家 CLI 完成訂閱登入，再檢查環境：
|
|
14
14
|
|
|
15
15
|
```bash
|
|
16
|
-
npm install -g agentflowctl
|
|
17
16
|
claude # 完成登入
|
|
18
17
|
codex # 完成登入
|
|
19
|
-
agentflowctl doctor
|
|
18
|
+
npx agentflowctl doctor
|
|
20
19
|
```
|
|
21
20
|
|
|
22
21
|
`doctor` 會列出已安裝的 CLI，並印出即將使用的輪替順序。沒有 `flow.config.json` 時，會自動採用偵測到的 CLI。
|
|
@@ -24,9 +23,17 @@ agentflowctl doctor
|
|
|
24
23
|
在專案資料夾內開始一次 run：
|
|
25
24
|
|
|
26
25
|
```bash
|
|
27
|
-
agentflowctl run --req "登入表單加上 zod 驗證與錯誤訊息"
|
|
26
|
+
npx agentflowctl run --req "登入表單加上 zod 驗證與錯誤訊息"
|
|
28
27
|
```
|
|
29
28
|
|
|
29
|
+
想把指令縮成 `agentflowctl` 時，再全域安裝：
|
|
30
|
+
|
|
31
|
+
```bash
|
|
32
|
+
npm install -g agentflowctl
|
|
33
|
+
```
|
|
34
|
+
|
|
35
|
+
下面的指令都寫成 `agentflowctl`；沒有全域安裝時，在前面加上 `npx` 即可。
|
|
36
|
+
|
|
30
37
|
這次 run 在專用 git worktree（`.agentflowctl/worktrees/<id>`）裡工作，基底是你目前的分支，新分支名是 `flow/<id>`。你正在編輯的工作目錄不會被改到。
|
|
31
38
|
|
|
32
39
|
從原始碼安裝：
|
|
@@ -207,7 +214,7 @@ agentflowctl 本身只依賴 Node.js 與 git。專案指令透過系統 shell
|
|
|
207
214
|
|---|---|
|
|
208
215
|
| 自己的電腦 | 自己的專案、自己寫的需求。剛開始可以加 `--manual-plan`，確認審查品質後再拿掉 |
|
|
209
216
|
| CI、容器、遠端開發機 | 無人值守。見 `examples/github-actions.yml`：issue 加上標籤就跑完並開 PR |
|
|
210
|
-
| Claude Code、Codex 裡面 | 讓它們用 shell 執行 `agentflowctl` |
|
|
217
|
+
| Claude Code、Codex 裡面 | 讓它們用 shell 執行 `npx agentflowctl` |
|
|
211
218
|
|
|
212
219
|
沒有容器隔離時，verify 會在你的電腦上執行 agent 寫出來的程式碼。Gemini 在無人值守時是 yolo 模式。處理外部 issue，或需求文字不是你自己寫的，放到可丟棄的環境。AI 審查計畫擋不住夾在需求裡的指示。
|
|
213
220
|
|
|
@@ -23,10 +23,8 @@ jobs:
|
|
|
23
23
|
- uses: actions/setup-node@v4
|
|
24
24
|
with:
|
|
25
25
|
node-version: 22
|
|
26
|
-
- name: 安裝 agent CLI
|
|
27
|
-
run:
|
|
28
|
-
npm install -g @anthropic-ai/claude-code @openai/codex
|
|
29
|
-
npm install -g agentflowctl
|
|
26
|
+
- name: 安裝 agent CLI
|
|
27
|
+
run: npm install -g @anthropic-ai/claude-code @openai/codex
|
|
30
28
|
- name: 執行 flow
|
|
31
29
|
env:
|
|
32
30
|
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
|
|
@@ -38,7 +36,7 @@ jobs:
|
|
|
38
36
|
git config user.name "agentflowctl"
|
|
39
37
|
git config user.email "agentflowctl@users.noreply.github.com"
|
|
40
38
|
printf '%s\n\n%s\n' "$ISSUE_TITLE" "$ISSUE_BODY" > /tmp/req.md
|
|
41
|
-
agentflowctl run --req-file /tmp/req.md --budget 10 --cycle claude,codex
|
|
39
|
+
npx agentflowctl run --req-file /tmp/req.md --budget 10 --cycle claude,codex
|
|
42
40
|
- name: 保存紀錄
|
|
43
41
|
if: always()
|
|
44
42
|
uses: actions/upload-artifact@v4
|