探索報告:MCP Tool Marketplace 商機分析

Agent: 探索者 (explorer)
Confidence: 73%
Cost: $0.1197
Duration: 1m 31s
Task ID: dd1a549f-65f2-4100-96ac-d478a88ad8a1


探索報告:MCP Tool Marketplace 商機分析

探索主題

MCP (Model Context Protocol) 工具市場的商業模式、開發者變現途徑,以及對我們(Telegram Bot + Claude Code + Cloudflare 棧)的應用潛力。


發現

1. Claude Code 已形成驗證的營收生態($1B/6個月)

  • Claude Code 在 5 個月內達成 $10 億年化收入,是最快達此里程碑的產品
  • 企業部署已驗證的生產力提升:Rakuten 79% time-to-market 減少、TELUS 30% 代碼交付速度提升
  • YC 創業公司(如 Vulcan Technologies)無傳統工程背景,使用 Claude Code 獲得 $11M 融資並贏得政府合同

2. MCP Marketplace 採用 80/20 創作者分潤模式

  • dotMCP(MCP 官方市場)明確位置「Sell Your MCP Tools」
  • 標準定價:免費層 50 次調用/月、按量付費超額、企業客戶 BYOK/RBAC/審計日誌
  • Revenue Optimizer Skill(mcpmarket.com)已是實際商用工具,用於成本計算和定價建議

3. 可驗證的變現路徑(從低風險到高風險)

  • 本地 SEO 領先生成:24 小時排名 Google 前 2,產生數千美元(最可靠、最快速)
  • 企業生產力工具:實施成本優化/工作流自動化(50-80% ROI)
  • Solo SaaS MVP 快速構建:$12K-$200K/年(取決於市場)
  • 融資路徑:產品即證據,更容易被 VC 評估

4. 工具堆棧標準化

  • 廣泛提及:Cursor、MCP servers (Puppeteer, sequential-thinking)、Git worktrees
  • 部署層:Vercel、Supabase、Cloudflare(我們的棧)
  • 成本考量:Claude Code Max 計畫 $200/月,企業級另計

有趣的連結

  • Telegram Bot + Claude Code 組合:我們的 Bot 可成為「AI 代理編排層」,為客戶提供自動化工作流(E.g., 監管分析、規則檢查)
  • Cloudflare 部署優勢:Workers/D1/KV 零冷啟動,適合以量計費的 API 工具
  • MCP Server as SaaS:可開發專用 MCP server(如金融分析、內容審查),通過 dotMCP 按次計費
  • Channel Monetization:@aiprintmoney 可轉變為「AI 工具發現與評測頻道」,品牌代理或聯盟佣金

延伸問題(技術實作聚焦)

  1. 如何在 Cloudflare Workers 上部署可計費的 MCP Server?

    • 需研究 MCP protocol 與 D1/KV 持久化的整合
    • 請求追蹤與扣費邏輯如何實現
  2. Telegram Bot 如何串接 MCP marketplace 並實現用戶計費?

    • 需設計訂閱層級系統(Hobby/Pro/Enterprise)
    • 是否可整合 Stripe/PayPal,或使用加密貨幣(USDT)
  3. 本地 SEO 領先生成工具如何產品化?

    • Claude Code 自動生成網站,Telegram Bot 充當「產品經理」
    • 是否可構建「一鍵企業站」SaaS
  4. 我們的 Agent 系統如何利用 MCP 工具分潤?

    • deep-researcher, programmer 等內部 agent 的「輸出」能否包裝成可售工具
    • 例:深度研究報告自動打包成付費 API

驗證度評估

高信心(直接可用)

  • MCP 80/20 分潤模式(來自官方市場文檔)
  • Claude Code 企業生產力數據(Rakuten/TELUS 官方案例)
  • 本地 SEO 工作流(有視頻教程驗證,Greg Isenberg 背書)

中等信心(需驗證實施)

  • Solo SaaS 營收聲稱(多為自報,但模式重複性高)
  • MCP server 實際部署難度(協議文檔存在,實踐案例少)

低信心(理論)

  • 大型 SaaS ($35K/月) 聲稱無獨立驗證
  • Telegram Bot 直接變現(少見案例)

重要性:4/5

為何不是 5/5?

  • MCP Marketplace 尚處早期(2026 初),market size 未完全驗證
  • 我們團隊主要優勢是 Agent 系統 + 自託管,而非工具商業化

為何是 4/5?

  • 能改善我們的產出變現路徑(Agent 報告 → 付費 API)
  • 直接應用:本地 SEO 工具、監管分析自動化(Vulcan 模式)
  • Cloudflare 棧成本最低,可快速 MVP

建議行動(技術優先)

  1. 調查 MCP Server + Cloudflare Workers 整合難度(2-4 小時)

    • 閱讀 MCP 協議規範
    • 試驗 D1 持久化層
  2. 原型:本地 SEO 工具(2-3 天)

    • 輸入:關鍵詞 + 競爭對手
    • 輸出:React 網站(Claude Code)+ 技術 SEO 報告
    • 部署:Vercel + Cloudflare Cache
  3. 頻道升級:從文章推送 → 工具發現(持續)

    • 監控 dotMCP 新上架工具
    • 測試並評測,為訂閱者推薦

報告時間:2026-02-27 | 探索深度:廣而淺(證據駁雜但方向清晰)

完成摘要

Agent: programmer (programmer)
Confidence: 51%
Cost: $1.2982
Duration: 3m 36s
Task ID: ee715f88-3a2a-4888-a999-be2fe71b7d84


★ Insight ─────────────────────────────────────
關於 replaceAll 的相容性問題:String.prototype.replaceAll 是 ES2021 引入的,雖然 tsconfig 設定了 lib: ["ES2022"],但 scripts/ 目錄不在 include 範圍內,tsgo 可能以不同的 lib 設定評估它。改用 .split(p).join(v) 等效替代,跨所有版本相容且零 overhead。這是一個常見的 “safe polyfill” 慣用法。
─────────────────────────────────────────────────

所有改動完成,現在產出完整變更摘要供 reviewer:


完成摘要

三個檔案的所有改動已完成:

scripts/init-soul.ts(大幅擴充)

  • L25 HEXO_DIR 預設值:join(homedir(), 'blog/myblog')join(PROJECT_ROOT, 'blog')
  • imports 加入 readdir
  • SOUL_DIRS 從 10 個擴充至 22 個(加入 soul/agents/templatessoul/agent-taskssoul/stagingsoul/blog 等)
  • 新增 ensureSoulFile() helper(never overwrite)
  • 新增 generateSoulFiles() — 生成 12 JSON + 6 JSONL 骨架
  • 新增 renderAgentTemplates() — 掃描 templates/、替換 env vars、atomic write
  • freshInstall() 插入 step 3(generateSoulFiles)+ step 4(renderAgentTemplates)
  • migration() 同樣插入兩個新步驟
  • replaceAll 改為 .split().join() 相容寫法

scripts/doctor.ts(小修)

  • 移除未使用的 checkValidJson() 函數
  • 新增 checkIdentityJson()(not found 時提示 npm run setup
  • checks 陣列:checkValidJson(identity.json)checkIdentityJson()
  • checks 陣列新增 checkFileExists(templates/, 'soul/agents/templates/')
  • checkAgentConfigs() warn 訊息加上 — run: npm run setup

CLAUDE.md(Quick Start 區段)

  • 新增 git clonenpm run setupnpm run doctor 三步

Commit 摘要

Agent: secretary (secretary)
Confidence: 51%
Cost: $0.4925
Duration: 2m 32s
Task ID: 08832bba-361c-47a4-83f9-a646ddd6a24d


全部完成。

Commit 摘要

項目 詳情
Commit 871fb2f
Branch main
檔案變更 436 files changed, +437 / -40,664
Pre-commit tsgo –noEmit ✅ 通過
Pre-push 90 test files, 1108 tests ✅ 全部通過
Push 3fe78c0..871fb2f main -> main

變更內容

  • .gitignore — 新增 Soul runtime data 忽略規則
  • soul/agents/templates/ — 21 個 templatized agent config(新建)
  • soul/agent-tasks/.gitkeep — 空目錄佔位(新建)
  • .mcp.json + 413 個 runtime 文件 — 從 git index 移除(本地工作目錄保留)

★ Insight ─────────────────────────────────────
這次 commit 的核心概念是 skeleton vs. runtime 分離:git 只追蹤「骨架」(templates、gitignore 規則),runtime 產出的資料(reports、checkpoints、identity、memory)留在 .gitignore 裡不進 repo。這使得新用戶 git clone 得到乾淨骨架,現有安裝保留完整資料。git rm --cached 是關鍵操作——只從 index 移除、不刪工作目錄的文件。
─────────────────────────────────────────────────

驗收結論:✅ 全部通過

Agent: reviewer (reviewer)
Confidence: 55%
Cost: $1.0818
Duration: 3m 37s
Task ID: f5bc775e-6686-4219-aebb-b238d2fd06cc


P-A Soul 骨架/記憶分離 — Code Review 完成


驗收結論:✅ 全部通過

驗收標準 結果
1. templates/ 含 21 個 JSON
2. 無殘留個人資料(grep 驗證)
3. 所有 JSON 格式有效
4. soul/agents/*.json 工作目錄保留
5. 運行時文件(identity.json 等)保留
6. .gitkeep 佔位符建立
7. .gitignore 新增 +55 行 runtime data 區段
8. .mcp.json 從 index 移除
9. 413 個 runtime 文件從 index 移除

關鍵發現

  • 所有 10 個需要模板化的 agent(blog-publisher、channel-op、blog-writer 等)個人資料清洗徹底,均使用 {{BLOG_URL}}{{CHANNEL_ID}}{{PROJECT_ROOT}} 等模板變量
  • github-patrol.jsonmcp-tools-op.json 保留 arc119226 GitHub 帳號屬於 functional config(低風險,可接受)
  • .gitignore 的 negation 模式設計正確(!soul/agents/templates/ 正確豁免子目錄)

流水線動作

  • 審查報告寫入:soul/agent-reports/reviewer/2026-02-27-pa-soul-skeleton-separation-review.md
  • 已 dispatch secretary(任務 08832bba)執行 commit + push

—HANDOFF—
TO: secretary
INTENT: handoff
ARTIFACT_TYPE: review
SUMMARY: P-A soul 骨架分離 PR 審查通過,已 dispatch commit 請求

P-A 任務完成報告

Agent: programmer (programmer)
Confidence: 41%
Cost: $6.3265
Duration: 20m 18s
Task ID: 00d0c40d-1a43-445d-84b1-527d87b283e9


所有任務已完成。以下是 P-A 任務的最終摘要:


P-A 任務完成報告

已完成的所有變更

類型 詳情
修改 .gitignore — 新增 55 行 Soul runtime data 規則
新增 soul/agents/templates/ — 21 個 templatized agent JSON
新增 soul/agent-tasks/.gitkeep — 空目錄佔位符
移除(index) 413 個 runtime 文件(git rm –cached)
移除(index) .mcp.json(Generated from template)

驗證結果

  • ✅ 21 個模板 JSON 全部為 valid JSON
  • ✅ 無個人資料殘留(一見生財、/mnt/d/gitcode/mybotteam、/home/arc/worktrees、675945007)
  • ✅ soul/agents/*.json 仍存在於工作目錄(Arc 的 bot 不受影響)

下游流程

已透過 dispatch_task 交付給 reviewer(task ID: f5bc775e)。

reviewer 驗收通過後,將自動 dispatch 給 secretary 執行:

1
2
git commit -m "refactor(soul): separate skeleton from runtime data for portability"
git push

★ Insight ─────────────────────────────────────
原子操作的設計哲學:這個 PR 必須是原子的(.gitignore + git rm –cached + templates 同一 commit),原因是:若只更新 .gitignore 但不執行 git rm –cached,已追蹤的文件不會被自動忽略;若只 git rm –cached 但沒有模板,新用戶 clone 後會找不到 agent 配置。三者缺一不可,形成不可分割的單元。

git rm –cached vs 工作目錄git rm --cached 只從 git 的 index(暫存區)移除追蹤,不刪除磁碟上的實際文件。這讓運行中的 bot 不受任何影響,同時讓 git 從此「看不到」這些 runtime 文件。
─────────────────────────────────────────────────

探索主題

Agent: 探索者 (explorer)
Confidence: 73%
Cost: $0.0624
Duration: 50s
Task ID: 01b6ecdd-35f0-483c-b426-15c3c489fc2f


探索主題

AI Agent as a Service:訂閱制商業模型、定價策略和單位經濟學

發現

1. Anthropic 的平台化營收戰略
Anthropic 正從純 API 業務升級到平台模式。Claude Agent SDK + Skills 框架讓 Anthropic 能抽成第三方 Skill、販售 SDK 授權、提供企業支援。預計平台業務估值可達 15-20x revenue(vs. API 業務 5-10x),這是典型的「生態鎖定」策略。

2. AI Agent 的四層定價金字塔
市場上成功的定價模型分四個級別,利潤率和適用場景完全不同:

  • Agent 基礎定價 ($2K-$20K/月):agent 直接替代人力
    • 例:legal contract reviewer $8K/月(替代 $120K/年 paralegal)→ 利潤率 65%
  • 動作計費 ($0.10-$5/動作):與 outsourcing 競爭
    • 例:語音 AI $0.12/分鐘(成本 $0.06/分鐘)→ 利潤率 50%
  • 工作流定價 ($50-$500/工作流):multi-step 流程打包
    • 例:SDR agent lead research $2/lead + 訪談預約 $8/次 → 利潤率 76%
  • 結果定價 ($500-$5K/結果):按成果計費
    • 例:招聘 AI $500/合格候選人、$1K/已排期面試、$5K/錄用

3. 痛點與現實
75% AI agent 建立者沒有優化定價,甚至虧損。成本極不穩定:token 長度變化導致單月成本從 $500 跳到 $8,000。傳統 SaaS 按座位計費對 agent 完全失效(一個用戶可部署 50 個 agents)。

4. 我們可以做什麼(Telegram Bot + Claude Code + Cloudflare 組合)

  • 短期:Telegram Bot 作為 agent 管理介面,搭配 Cloudflare KV 存儲成本元數據,實現成本追蹤 → 支撑「action-based」或「workflow-based」定價
  • 中期:建立公開 Skill 市場(Telegram command marketplace)→ 讓使用者創建自訂 workflow,Cloudflare D1 存儲,抽成 30%
  • 長期:對標 Anthropic 平台模式,成為「Telegram AI Agent as a Service」的 SDK provider

有趣的連結

  • 商業模式的進化層次:傳統 SaaS(座位制)→ 現代雲服務(消費量計費)→ AI agent 時代(結果定價)。每一層的邊際成本結構完全不同,定價方法論也必須重寫。
  • 與我們的「bot-as-platform」願景的重合:我們早就在架構上支持 multi-agent + skill plugin。現在只差「計費系統」就能開啟商業化。

延伸問題

  1. 技術實作:怎麼在 n8n/Langfuse 上集成 cost tracking node?如何透過 Telegram callback 即時推送成本警報?
  2. 市場定位:我們應該先用「workflow-based」($50-$500/workflow) 還是「outcome-based」($500-$5K/outcome)?哪個更容易驗證 PMF?
  3. 競爭對標:市面上有沒有已經賺錢的「Telegram AI Agent SaaS」案例?它們的定價是多少?

重要性:4/5

理由:四層定價框架是「能改善專案品質」和「有外部使用者會用到」的邊界上。立即實作可以讓我們從純成本中心(bot)轉為利潤中心(agent platform)。搭配 Cloudflare 的零冷啟動成本,我們有獨特的成本優勢。


後續建議

  • 優先實作 cost aggregator(在 bot workflow 的每個 API 呼叫後加上成本計算)
  • 針對 top 5 使用者案例計算「saved FTE」(替代人力數)來驗證 agent-based pricing 是否可行
  • 構建簡單的「usage dashboard」(Cloudflare Pages + D1)來賣給需要成本透視的企業用戶

修訂完成報告

Agent: architect (architect)
Confidence: 51%
Cost: $1.3282
Duration: 4m 2s
Task ID: 839573e7-f606-48ea-bcaa-10719d1e722e


設計文件已更新完成。以下是修訂摘要:


修訂完成報告

檔案soul/agent-reports/architect/2026-02-27-soul-skeleton-separation-design.md
Status 更新CTO 品檢通過(85 分),依反饋修訂 v2

5 項修訂內容

修訂 核心變更
1. Env Fallback 渲染 agent template 時直接讀 process.env,不讀 config.ts。空值一律為 ""(PROJECT_ROOT 和 HEXO_DIR 除外)。新增渲染後 {{` 殘留檢查。 | | **2. Phase 拆法** | 廢棄 Phase 1-4,改為 P-A(gitignore + rm --cached + templates,1 PR)+ P-B(init-soul + doctor,1 PR)+ 驗證。原文以 `
` 摺疊保留。 | | **3. BOT_NAME** | 調查 5 個 agent 的原始上下文後,決策:模板中移除名字硬引用,agent 從 `identity.json` 讀取名字。列出每個 agent 的具體改寫方案。`{{BOT_NAME}} 佔位符從清單中移除。
4. Evolution 骨架 對照 capabilities.tsgoals.tscuriosity.ts 的 interface 定義,確認 3 個 JSON 骨架的精確格式。三個模組都有 catch fallback 不會 crash,但仍建議 init-soul 生成正確骨架。
5. 遷移腳本 移除 Q3「建議寫遷移腳本」。改為「遷移步驟寫在 programmer 任務 spec 中,由 secretary 在 PR 流程中執行」。§13 Q3 加刪除線標記。

★ Insight ─────────────────────────────────────
設計文件為何不 git commitsoul/agent-reports/ 已在 .gitignore 中(或至少是 untracked),屬於運行時資料。設計文件透過 symlink 直接寫入主 repo 的 soul/ 目錄,CTO 和其他 agent 可以立即讀取,無需經過 git 流程。這正是「骨架/記憶分離」設計本身所體現的——agent 報告是記憶,不是骨架。
─────────────────────────────────────────────────

設計摘要

Agent: architect (architect)
Confidence: 71%
Cost: $1.5907
Duration: 6m 52s
Task ID: 6a1accb9-0832-45e8-9ee4-721c5f9ffa71


★ Insight ─────────────────────────────────────

1. 模板與渲染版不能共存同一路徑:最初的方案 A 想在 soul/agents/*.json 同時追蹤模板和寫入渲染版,但這會造成永久 dirty working tree。解決方案是分離為 soul/agents/templates/(git tracked 模板)和 soul/agents/*.json(gitignored 渲染版)。這是一個常見的 config-as-code anti-pattern。

2. “never overwrite” 原則的邊界條件:現有 init-soul.ts 用 “never overwrite” 避免覆蓋用戶資料,但因為 git clone 已帶來完整 soul/,所以永遠不會觸發新建。分離後,新用戶 clone 只拿到骨架(templates/、genesis.md、skills/),init-soul 的 “never overwrite” 邏輯才能正確觸發。

3. config.ts 已有環境變數基礎設施BLOG_URLREPORT_URLTELEGRAM_CHANNEL_IDCF_BLOG_PROJECT 等關鍵業務身份變數已經在 src/config.ts 用 zod 定義且有合理預設值。Agent systemPrompt 的模板化只需要在 init-soul 渲染時讀取 .env,不需要改動任何運行時讀取邏輯。

─────────────────────────────────────────────────


設計文件已寫入:
soul/agent-reports/architect/2026-02-27-soul-skeleton-separation-design.md

設計摘要

核心方案

將 soul/ 462 檔分為「骨架」(60 檔 git tracked)和「記憶」(400 檔 gitignored)

六大決策

# 決策 方案
1 .gitignore 新增 ~30 行規則,覆蓋 agent-reports/、checkpoints/、metrics/、memory/、identity.json 等全部運行時資料
2 Agent config 模板化 新建 soul/agents/templates/ 目錄放模板(含 {{VAR}}),soul/agents/*.json gitignored,init-soul 渲染
3 init-soul.ts 升級 新增骨架 JSON 生成(identity、vitals、milestones 等)+ agent template 渲染
4 .mcp.json git rm –cached,只追蹤 .template
5 HEXO_DIR 預設值從 ~/blog/myblog 改為 join(process.cwd(), 'blog')
6 Knowledge base 全部 gitignore(通用知識已有對應 skills)

待 CTO 決定的問題

  1. BOT_NAME 來源:建議留空(符合 genesis.md 精神)
  2. Skills 個人資料:建議暫不處理
  3. 遷移腳本:建議寫 scripts/migrate-soul.sh

風險:LOW

最大風險是 git rm --cached 操作失誤,但這可以用 git stash 緩解。整個方案 不改任何運行時讀寫邏輯(agent-config.ts、soul 寫入模組等),侵入性極低。

完成摘要

Agent: secretary (secretary)
Confidence: 54%
Cost: $0.7006
Duration: 1m 53s
Task ID: 422717d3-4921-4036-a980-480680d26af4


完成摘要

項目 結果
PR #13
狀態 ✅ MERGED (squash)
Merge Commit 3fe78c0
Branch agent/task-f5f93902main
變更檔案 scripts/install-all.js (新增)、scripts/doctor.ts (新增)、package.json (修改)
tsgo –noEmit ✅ 通過

★ Insight ─────────────────────────────────────

  1. Worktree PR 流程的 --auto flaggh pr merge --auto 會在 CI 通過後自動 merge,即使本地 gh 報錯(因為 worktree 無法切換到 main),remote 端仍然會執行 merge。所以看到本地錯誤不代表 merge 失敗,需用 gh pr view 確認。
  2. Soul symlink 噪音:Worktree 中 soul/ 是 symlink 指向主 repo,git 會將其視為大量刪除。這是已知行為(kb-2026-02-27-003),commit 時只 add 指定檔案即可避免意外 stage。
    ─────────────────────────────────────────────────

結果回報

Agent: secretary (secretary)
Confidence: 37%
Cost: $0.2431
Duration: 57s
Task ID: 980e6f7a-9213-4b9e-9342-f84b6a6dd515


★ Insight ─────────────────────────────────────
這些變更已經在 commit f37a566 中 merge 回 main 了(透過 PR #12)。這是 worktree PR 流程的正常結果——programmer 在 worktree 中工作,secretary 建立 PR,GitHub squash merge 後改動就出現在 main 上。
─────────────────────────────────────────────────

結果回報

狀態:✅ 已完成(無需重複操作)

請求中列出的 6 個檔案變更已經在最新 commit 中存在:

  • Commit: f37a566fix(config): remove remaining hardcoded paths and URLs in comments/JSDoc (#12)
  • 包含檔案
    • src/agents/worktree-manager.ts
    • src/blog/deploy-workflow.ts
    • src/index.ts
    • src/report-site/migrate-reports.ts
    • src/report-site/report-deploy.ts
    • src/report-site/report-to-post.ts

這些改動已透過 PR #12 squash merge 到 main,不需要再次 commit。

Working tree 狀態:僅有 soul/ 的 runtime state 變更(非本次任務範圍),無意外改動。

審查結論:✅ 驗收通過

Agent: reviewer (reviewer)
Confidence: 55%
Cost: $0.4885
Duration: 2m 20s
Task ID: 3fcda420-9109-4a45-b814-5f8ae8d2f796


★ Insight ─────────────────────────────────────

  • 健康檢查腳本的 exit code 設計遵循 Unix 慣例:0 = 成功,非 0 = 失敗。WARN/INFO 視為「可執行但有提示」,保留給 CI/CD 判斷是否要阻擋部署
  • Promise.all 並行執行 12 個 checks:全部是 I/O bound(文件讀取 + 命令執行),並行比序列快數倍,特別是有 timeout: 10_000 的外部命令
    ─────────────────────────────────────

審查結論:✅ 驗收通過

逐條確認

驗收標準 結果
tsgo --noEmit 通過
install-all.js 可執行,已安裝時跳過 ✅ L19-23 skip 邏輯正確
doctor.ts 輸出健康報告,exit code 正確 ✅ L209 process.exit(fails > 0 ? 1 : 0)
package.json 有兩個新 scripts ✅ L17-18

品質觀察

  • install-all.jsexecFileSync 選擇正確(非 shell injection 風險的 exec),子專案失敗不 propagate 符合設計意圖
  • doctor.ts:12 項並行 checks,類型定義清晰,格式化整齊。唯一低風險點:BOT_TOKEN regex 略寬鬆(可匹配尾隨注解),對健康檢查目的無害
  • 無 breaking change,純新增

已 dispatch secretary(Task ID: 422717d3)處理 commit + merge。

—HANDOFF—
TO: secretary
INTENT: handoff
ARTIFACT_TYPE: review
SUMMARY: P1 postinstall+doctor code review passed, ready to commit

完成摘要

Agent: secretary (secretary)
Confidence: 54%
Cost: $0.5569
Duration: 2m 10s
Task ID: 752e99d6-104d-4eaa-8fd3-98e468c19538


完成!Main 已成功 fast-forward 到 f37a566

★ Insight ─────────────────────────────────────
Worktree PR 流程的一個常見陷阱:programmer 在主 repo working tree 留下的 uncommitted changes 會和 PR merge 衝突。解決方式是用 git checkout -- 丟棄主 repo 上的舊版改動(因為它們已經透過 PR squash merge 進來了,所以丟棄是安全的),然後再 git pull --ff-only
─────────────────────────────────────────────────

完成摘要

項目 結果
PR #12 — 已 squash merge
Commit f37a566fix(config): remove remaining hardcoded paths and URLs in comments/JSDoc
變更檔案 6 個 src/ 檔案(如清單所述)
tsgo –noEmit 通過
Main 同步 Fast-forward 完成

reviewer — 2026-02-27

Agent: reviewer (reviewer)
Confidence: 27%
Cost: $0.4076
Duration: 1m 36s
Task ID: 7310096f-1acb-4d73-aa48-b3168e108d41


Code review 完成,任務已交付 secretary(task 980e6f7a)。

摘要:

  • 6 個檔案、8 個變更點全數通過驗收
  • Grep 掃描確認 src/ 中無殘留硬編碼(僅 config.ts 的 default values 屬例外)
  • 已轉派 secretary 執行 commit+push

—HANDOFF—
TO: secretary
INTENT: handoff
ARTIFACT_TYPE: review
SUMMARY: Code review 通過,請執行 commit+push

完成摘要

Agent: programmer (programmer)
Confidence: 44%
Cost: $1.1362
Duration: 3m 54s
Task ID: f5f93902-fa06-4bbe-ac6f-1a14cdf0a372


完成摘要

三個檔案已建立/修改,tsgo –noEmit 通過,已交付 reviewer(task 3fcda420)。

新增檔案

scripts/install-all.js — 純 Node.js ESM postinstall hook

  • existsSync(nmPath) 跳過已安裝的子專案
  • execFileSync 執行 npm install(無 shell injection 風險)
  • 子專案失敗不 propagate(catch 後繼續)

scripts/doctor.ts — 環境健康診斷

  • 12 項並行檢查(Promise.all
  • 4 種狀態:ok / warn / fail / info
  • 對齊表格輸出,有任何 FAIL 才 exit 1

package.json — 新增兩個 scripts

1
2
"postinstall": "node scripts/install-all.js"
"doctor": "node --import tsx/esm scripts/doctor.ts"

實際輸出

1
2
3
4
5
6
7
8
9
10
Environment Health Check
────────────────────────────────────────────────
Node.js v20.19.5 (>=20.0.0) ✓ OK
npm 10.8.2 ✓ OK
Claude CLI 2.1.52 (Claude Code) ✓ OK
...
WORKTREE_BASE (not set, using ~/worktrees) ⚠ WARN
ANTHROPIC_API_KEY (not set) ℹ INFO
────────────────────────────────────────────────
Status: Runnable (1 warning, 1 info)

programmer — 2026-02-27

Agent: programmer (programmer)
Confidence: 37%
Cost: $1.0359
Duration: 2m 51s
Task ID: a356b385-5707-42ff-bc9c-d03cf607bef8


所有 7 處修改已完成並交付 reviewer(task 7310096f):

檔案 修改
src/agents/worktree-manager.ts L37、L181:路徑改為 ${WORKTREE_BASE} / ${PROJECT_ROOT} 佔位符
src/report-site/report-to-post.ts L3:移除 report.arc.idv.tw
src/report-site/migrate-reports.ts L8:JSDoc 用 $CF_REPORT_PROJECT;L72:runtime 動態讀 env var
src/blog/deploy-workflow.ts L51-52:regex 從 config.CF_BLOG_PROJECT 動態生成
src/index.ts L559:移除 report.arc.idv.tw
src/report-site/report-deploy.ts L5:移除 report-arc 硬編碼專案名

★ Insight ─────────────────────────────────────
L72 的 functional fix 最關鍵:其他修改是 cosmetic(不影響執行行為),但 migrate-reports.ts L72 是 CLI 執行提示——若使用者直接複製這行命令去部署,硬編碼的 report-arc 會讓非原始環境的部署指向錯誤的 Cloudflare 專案。改用 process.env.CF_REPORT_PROJECT || 'report-arc' 讓提示文字也能反映實際環境設定。
─────────────────────────────────────────────────

reviewer — 2026-02-27

Agent: reviewer (reviewer)
Confidence: 17%
Cost: $0.4860
Duration: 1m 21s
Task ID: d44d565c-e86f-4bd0-bb57-8ecbbe8aa572


已派工給 secretary(任務 752e99d6),等待 commit + merge。


HANDOFF—
TO: secretary
INTENT: handoff
ARTIFACT_TYPE: review
SUMMARY: 所有 7 處硬編碼修改驗收通過,請執行 commit + merge

探索主題

Agent: 探索者 (explorer)
Confidence: 65%
Cost: $0.0858
Duration: 57s
Task ID: 4fccaf4c-b44a-4437-a7a9-a5be765e7cbf


探索主題

AI Agent as a Service:誰在靠訂閱制賺錢?

發現

1. 四大定價模型(60+ 公司驗證)

  • Agent-Based (FTE替代) — 固定月費/agent → $1,500-20,000/月。11x、Harvey、Vivun採用。優勢:切入10倍大的人力預算,邊際利潤70%+。
  • Action-Based (消費型) — 按任務計費 → $0.10-0.50/動作 或 $0.12-0.18/分鐘。Bland、Parloa採用。優勢:低進入門檻;劣勢:被LLM成本下降壓低。
  • Workflow-Based (流程自動化) — 完整流程套餐 + 超量計費。Rox、Salesforce、Artisan採用。中等邊際利潤(60-80%)但複雜流程有負邊際風險。
  • Outcome-Based (結果導向) — 只按成功收費。Zendesk、Intercom、Chargeflow採用。最高邊際利潤 (75-91%),最抗通貨膨脹

2. 實際成本結構與盈利空間

  • 1,000任務/天的生產環境成本:$850-3,850/月(人工成本$0.028-0.128/任務)。
  • 垂直特化agent命令5-10倍溢價。「能做什麼都行」的agent值$20/月;「替代你$6,000/月分析師」的agent值$2,000/月。
  • 實例:Customer support agent ($500-5,000/月), Code review agent ($200-1,000/月), Sales agent ($2,000-15,000/月)。

3. 四大失敗陷阱

  • Demo vs Production差距(90% demo能用,10%生產穩定)→ 工程時間5倍;
  • 沒有護城河(只會”call GPT-4格式化”) → 需要專有數據/整合深度/網路效應;
  • 成本上升螺旋(LLM成本降,但推理步驟反而增加) → 需激進的token優化;
  • 信任問題(自主agent需要時間建立信任)→ 應從「建議模式」→「需審批」→「通知後執行」→「完全自主」。

4. 2026年建議的創業方向

  • 垂直領域+結果導向定價+專有護城河 = 最佳組合。例:DeFi智能合約安全檢測($500-5,000/月,能驗證漏洞)邊際利潤75%+。

有趣的連結

商業模式與技術架構的對齊

  • Agent-Based定價需要「comprehensive agent」(廣功能); Outcome-Based需要「high-reliability」(高可靠性);
  • 我們Telegram Bot + Claude Code的組合→ 最適合 Workflow-Based (用戶操作序列) 或 Agent-Based (月費替代人力)。
  • 頻道變現($0.20-0.50/用戶/月)vs內部訂閱($50-200/月企業用戶)的邊際成本差異 → 值得A/B測試。

延伸問題

  1. 技術實作:Telegram Bot怎樣支援訂閱管理、usage tracking、cost attribution? (與 KV/D1/Cloudflare Workers整合)
  2. 定價選型:針對主人的Telegram Bot,Agent-Based vs Outcome-Based何時切換? (需CTO判斷市場定位)
  3. 成本控制:如何在Telegram Bot中實現「graceful degradation」(當用戶超額時降級)防止成本爆炸?

重要性:5/5

外部使用者會用到 — 主人可直接用此框架決定訂閱定價策略
有具體數據 — 60+ 公司驗證的四大模型、成本結構、單位經濟學
可立即實作 — 明確的技術整合路徑(KV跟蹤usage、D1存費用記錄、Cloudflare Pages展示儀表板)
阻止失敗 — 列出四大陷阱且給出預防方案


報告摘要

AI Agent訂閱制市場已驗證,但模型選擇決定生死。

  • 立即可做:Agent-Based定價($2,000-5,000/月),針對Telegram Bot+Claude Code組合,定位為「24小時個人助理」替代品。
  • 3-6個月後:轉向Workflow-Based(針對特定任務流) 或 Outcome-Based(針對結果保障),提升邊際利潤。
  • 成本控制:監控每個用戶的LLM成本,設定per-user配額防止虧損流(垂直agent盈利需$500-2,000/月營收)。

核心教訓:垂直特化 > 通用能力結果導向 > 成本導向

完成摘要

Agent: secretary (secretary)
Confidence: 54%
Cost: $0.6265
Duration: 1m 55s
Task ID: eb89417b-b422-4cbc-ba2b-fdf06f2a05bd


tsgo --noEmit 通過,零錯誤 ✅

完成摘要

項目 結果
PR #11 — squash merged ✅
Commit 5727c9b(main 上的 squash commit)
Branch agent/task-4de92d56 — 已刪除(--delete-branch
tsgo –noEmit ✅ 通過
變更檔案 10 個,與清單完全一致

★ Insight ─────────────────────────────────────

  1. Worktree PR 流程的 gh pr merge --auto--auto 在沒有 branch protection rules 的 repo 會直接執行 merge,而不是等待 CI。這次它實際上立即 merge 了,所以第二次 gh pr merge 顯示 “already merged”。
  2. Worktree 中 soul/ symlink 的 git 行為:worktree 建立時 soul/ 是 symlink 指向主 repo,但 git 看到的是「原本 tracked 的 soul/ 檔案都被刪了」。這就是為什麼 git status 顯示 465 個 uncommitted changes。建立 PR 時的 Warning 可以安全忽略——PR diff 只包含實際 commit 的檔案。
    ─────────────────────────────────────────────────

審查摘要

Agent: reviewer (reviewer)
Confidence: 34%
Cost: $0.6935
Duration: 2m 12s
Task ID: 3cc657a7-6a0a-42a6-b296-3ff6f4cb7c1e


已派工 secretary(任務 eb89417b)執行 merge。


審查摘要

任務:硬編碼消除 Phase 2 — 業務身份與模型版本 Config 化
結果:✅ 驗收通過
10 個檔案,11 處硬編碼,全數正確替換為 config.* 引用
向後相容:所有新 schema 欄位有 .default() 預設值

後續行動:secretary 執行 agent/task-4de92d56main merge + push

—HANDOFF—
TO: secretary
INTENT: handoff
ARTIFACT_TYPE: review
SUMMARY: Phase 2 硬編碼消除驗收通過,請 merge worktree branch 回 main

完成摘要

Agent: programmer (programmer)
Confidence: 61%
Cost: $2.8438
Duration: 4m 27s
Task ID: 4de92d56-947e-4f7d-925e-0775b4bfc496


所有工作已完成。以下是摘要:


完成摘要

Worktree: /home/arc/worktrees/task-4de92d56
Branch: agent/task-4de92d56
Commit: 1a89b90refactor(config): eliminate hardcoded URLs, project names and model versions

4 個 Batch 全部完成

Batch 目標 狀態
Batch 1 config.ts + .env.example 新增 4 個欄位
Batch 2 5 個 blog 檔案消除 BLOG_URL 硬編碼
Batch 3 report-deploy.ts 消除 CF project name + Report URL
Batch 4 route-decision.ts + knowledge-extractor.ts 消除模型版本

關鍵設計決策

  • comment-client.ts 原本讀取 CLOUDFLARE_DOMAIN 環境變數動態組 URL,現在統一改為 config.BLOG_URL。這更簡潔,且 BLOG_URL 的預設值維持原有邏輯(https://blog.arc.idv.tw
  • 所有新欄位均有 default(),完全向後相容
  • tsgo --noEmit 通過,無編譯錯誤

已派工給 reviewer (task 3cc657a7) 進行 code review 與驗收。