An API contract diagram (inputs, outputs, scope) overlaid on a SKILL.md file, showing the two are the same shape
AI Systems看中文版

Skill Design as Interface Design

An agent skill behaves predictably to the exact degree its boundary is specified. Treat it as a capability list and it drifts; treat it as a contract (declared inputs, outputs, and scope), and it behaves like a well-designed API.

2026-05-25 · 2 min read · 865 words · KbWen · EN
一條有上限的成本天花板,旁邊是沒有上限的成本曲線,中間標出快取甜蜜點:太粗與太細之間的顆粒度
AI SystemsRead in English

Token 成本的真相:分級,但別分太細

把 token 當設計變數而非月底帳單:粗放的任務成本沒有上限,但分太細也不會更省。快取讓過度切分反而更貴,重點是找到對的顆粒度。

2026-05-25 · 5 min read · 2144 words · KbWen · ZH
A bounded cost ceiling beside an open-ended cost curve, with a cache-locality sweet spot marked between too-coarse and too-fine task granularity
AI Systems看中文版

Token Economics of AI Agent Governance

Governance has a bounded, knowable token cost; ungoverned agent work tends not to. And task granularity has its own price: caching can make over-decomposition cost more than it looks.

2026-05-25 · 3 min read · 1414 words · KbWen · EN
Two task cards: a red 'no artifact' card versus a teal card with commit SHA and 47 passing tests as verified evidence
AI Systems

No evidence, no completion

No evidence, no completion: the one rule that closes most AI agent failures. A task isn't done until it produces a verifiable artifact (commit SHA, test output).

2026-05-22 · 6 min read · 1156 words · KbWen · EN
一條 Work Log 時間軸串連 Session 1 到 4,跨越中間的 gap 缺口維持任務連貫
AI Systems

Work Log:跨 session 的記憶機制

AI 代理每個新對話都失憶?Work Log 用一份 markdown 記錄任務進度與決策,讓 Claude Code 跨 session 接續,不用每次重講背景。

2026-05-22 · 6 min read · 2511 words · KbWen · ZH
A message queue with a dropped no-ACK message mapped to a passing phase pipeline, showing the same pattern
AI Systems

Prior art: what distributed systems already knows

AI agent governance maps onto distributed systems patterns: audit logs, delivery acknowledgment, idempotency, least privilege. The prior art already exists.

2026-05-22 · 6 min read · 1130 words · KbWen · EN
以 CLAUDE.md 記憶檔為中心,連向 evidence、boundaries、scope、context、rules、memory 的節點圖
AI Systems

只用 Prompt 和技能,也能做到基本治理

不用框架也能治理 AI 代理:靠 AGENTS.md / CLAUDE.md 記憶檔、evidence 習慣和範圍宣告,就能擋掉大部分 Claude Code、Cursor 的常見問題。

2026-05-22 · 6 min read · 2803 words · KbWen · ZH
Two fractal trees — one chaotic and orange, one orderly and teal — contrasting ungoverned vs governed agent behavior
AI Systems

Why AI Agents Go Wrong: It's Not the Model

Why AI agents fail: most agent failures aren't model problems, they're governance problems, and the two need completely different fixes. How to tell them apart.

2026-05-22 · 4 min read · 1852 words · KbWen · EN
左側雜亂的網路節點圖(ungoverned)對比右側整齊的網格流程圖(governed)
AI Systems

AI 代理常見痛點與我們的嘗試

AI 代理(AI Agent)開發常見問題整理:輸出難核查、跳步驟、跨對話失憶、範圍失控。從實戰痛點到 Agentic OS 的應對方向,附 Claude Code 實例。

2026-05-22 · 6 min read · 2782 words · KbWen · ZH
AI system architecture layers: Model, Tool, Skill, Workflow, Agent, Application
AI Systems

What Makes an AI Skill Different from a Prompt?

Most teams treat AI skills as saved prompt templates. They're not. A proper Skill is a capability contract—with input schemas, tool bindings, validation, and retry logic. Here's what that distinction means for production system design.

2026-04-16 · 7 min read · 1465 words · KbWen · EN