重开仓库内容：改推五个技能（browser-harness / humanizer / humanizer-zh / product-planning / session-mechanism）

按授权清空原有内容后重新提交（原 oil-ui-pro 一并移出，可从历史恢复）。 browser-harness 剔除 .venv 等运行环境；根 .gitignore 补记 .venv/ 与 node_modules/。
2026-10-07 16:06:02 +08:00
1 parent 9a152a1952
commit 777f7fe5d0
@@ -0,0 +1,68 @@
+# TaskSquad — Agents
+
+Field-tested against tasksquad.ai on 2026-05-03 using a logged-in Chrome session.
+
+## URL
+
+```
+https://tasksquad.ai/dashboard/agents       # Agents list for current project
+```
+
+## Agent list
+
+Agents are the daemon workers that execute tasks. Each agent card shows:
+- Name
+- Status badge (`active` / `inactive` / `running` / `waiting_input` / `paused`)
+- Role (optional label set by maintainer)
+- Last-seen timestamp
+
+Navigate to agents via the sidebar link "Agents".
+
+## Creating an agent
+
+Maintainer/owner only. Click **"New agent"** (or similar CTA in the agents view).
+
+Provide:
+- **Name** — display name for the agent
+- **Role** (optional) — a freeform string describing the agent's specialty
+
+After creation, a **token** is generated. Copy it immediately — it is shown only once. The daemon uses this token to authenticate.
+
+```
+tsq install --token <TOKEN>
+```
+
+Tokens are created via `POST /teams/:teamId/tokens` with `{ label, agent_id }`.
+
+## Agent statuses
+
+| Status          | Meaning                                            |
+|-----------------|----------------------------------------------------|
+| `active`        | Daemon connected, ready to accept tasks            |
+| `inactive`      | Daemon not connected (no recent ping)              |
+| `running`       | Currently executing a task                         |
+| `waiting_input` | Paused mid-task, waiting for user reply            |
+| `paused`        | Manually paused — will not pick up new tasks       |
+
+## Agent actions (maintainer / owner)
+
+| Action       | Trigger                  | Effect                                              |
+|--------------|--------------------------|-----------------------------------------------------|
+| Pause/Resume | Toggle button on card    | Sets `paused` flag — agent ignores new tasks        |
+| Reset        | "Reset" button           | Clears the agent's running state (use if stuck)     |
+| Delete       | Delete button / menu     | Permanently removes agent and its tokens            |
+| Edit role    | Role edit control        | Updates the agent's role label                      |
+
+## Token management
+
+Tokens are per-agent credentials. Each token has a label. A maintainer can:
+- **Generate a new token** — use when setting up a new machine or rotating credentials
+- Tokens cannot be viewed after creation; only revoked implicitly by deleting the agent
+
+## Gotchas
+
+- **Status is driven by daemon pings**, not task state. An agent can be `active` while no task is running.
+- **`inactive` ≠ paused.** Inactive means the daemon process is offline. Paused means a maintainer explicitly suspended it via the UI.
+- **Only owners and maintainers can create agents or generate tokens.** Members see the list but cannot modify it.
+- **Token is shown once.** If you miss copying it, you must generate a new one — there is no "reveal token" button.
+- **Reset is for recovery only.** Use it when an agent is stuck in `running` after a daemon crash. Do not reset agents mid-task.