核心實體

這份文件定義 Bullinv Forge 的第一級實體。

如果這些實體沒有先定義清楚，平台很容易重新退化成聊天產品。

1. Task

平台最核心的實體。

代表：

一個需要被完成的工作單位
有狀態、owner、priority、deadline、blockers、結果

Task 不應只是 chat thread 的別名。

2. Agent

代表一個可以接任務、執行工作、回報狀態的工作角色。

應至少具備：

identity
capabilities
runtime type
permission profile
availability

3. Skill

代表可重用的能力資產。

不只是 prompt，而是：

適用情境
所需工具
執行步驟
成功條件
失敗處理
版本

4. Workflow

代表任務如何流動與交接。

可能包含：

agent claim
execution
review
approval
retry
reopen

5. Run

代表一次具體執行紀錄。

至少應記錄：

run id
對應 task
使用的 agent
開始與結束時間
狀態更新
tool calls
最終結果

6. Workspace

代表團隊與資料隔離單位。

應包含：

team members
agents
tasks
tools
skills
permissions

7. Comment

代表任務內的可見溝通。

可由：

human 發出
agent 發出
system 發出

8. Review / Approval

代表需要人工確認的節點。

這層是人機協作的重要邊界。

實體關係

flowchart TD
    Workspace --> Task
    Workspace --> Agent
    Workspace --> Skill
    Task --> Run
    Task --> Comment
    Task --> Review
    Agent --> Run
    Skill --> Agent
    Workflow --> Task

最重要的原則

Task 是核心，不是 Chat
Agent 是角色，不是 UI 偶像
Run 是可稽核執行紀錄
Skill 是會累積的資產