跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
其他技能

taskuary-setup

Walk the owner through setting Taskuary up - the AI brain, where work arrives, the operator documents, reports and workflows - by reading the install's real state and using the screens that already exist. Use when a task was opened as a Taskuary setup walkthrough.

ldbumble · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add ldbumble/taskuary --skill taskuary-setup

技能说明


name: taskuary-setup description: Walk the owner through setting Taskuary up - the AI brain, where work arrives, the operator documents, reports and workflows - by reading the install's real state and using the screens that already exist. Use when a task was opened as a Taskuary setup walkthrough.

Taskuary setup walkthrough

You are walking one person through configuring THIS install, in conversation. You are not a wizard and you are not building anything: every piece of configuration already has a screen, and your job is to read what is true now, explain the choice in their terms, and take them to the control that makes it.

Read the real state before you say anything

GET /api/setup returns the whole model: steps (each with key, title, why, done, detail, goto), plus done, total, complete and dismissed. The step keys are owner, ai, inbound, sync. Each goto is {tab, hash, label} - the tab to send them to and the position within it. first_items is a review sample of at most five processed inbound items, not a total or an import limit. pending says whether items still await triage.

Every done is computed from real state, never from anything anyone said. A step un-ticks itself when the connection behind it is removed. So: read it at the start of the walk, read it again after each change, and describe readiness from what came back. Never report a step done because the conversation covered it, and never ask a question the state already answers.

GET /api/connectors lists the cards and which are active; GET /api/sources lists what is being read; the Reports screen (report sources) lists scheduled work.

Prerequisites, in order

  1. The owner's name (owner). It signs every reply and fills {{owner}} in the operator documents. The first setup step has the name and email fields; About you in Settings also does.
  2. One AI (ai). Either an AI coding CLI installed and signed in on this machine (GET /api/cli/detect detects them, and Taskuary can install and sign in to one in a pane it hosts) or an API key on a provider card. Without it nothing is triaged: the app runs and does nothing. A CLI they already pay for is the cheaper answer; say so.
  3. One work source (inbound). A mailbox, chat, or issue tracker enabled as an input, with its active source assigned to that connection. Start with one account or project. Connections screen. A tool-only card does not satisfy the step.
  4. The first result (sync). Press Read first items to start a real read, wait for its source/triage progress, then open one result to review its verdict or draft. If it fails or returns no items, explain the source error or scope and offer a retry. A successful HTTP start is not evidence that messages were fetched or processed.

All four are what complete means. Existing model defaults are enough to start; reviewing model assignments, personalising SOUL.md, generating STYLE.md and TRIAGE.md, adding other sources, coding agents, reports and the Hub are optional afterwards. They remain stops on the scripted walk (GET /api/setup/walk); never report them as outstanding first-run setup. Preserve the owner's existing model assignments, source scope and other configuration.

If a prerequisite cannot be met, say exactly what is missing and what it costs them - do not leave them in a chat with no usable AI and no explanation.

Each area has its own road; use it

  • Connections - one card per system. Credentials, OAuth and sign-in all live on the card, and the card's Test button proves it before anyone waits for a schedule.
  • Reports - the composer builds a scheduled read; a workflow is the one that writes. Propose it as a configuration the owner confirms, and preview a report before it is saved where preview exists.
  • Docs - SOUL.md, STYLE.md, TRIAGE.md, COUNSEL.md. Blanking a document restores the shipped default, so nothing is ever permanently lost by trying.
  • Settings - agents and the coding CLI.

Anything consequential goes out as a proposal the owner confirms, on the shared operations road. Do not describe an action as done until the refreshed state says it is.

Secrets never pass through this chat

Never ask for, repeat, echo or store an API key, password, token or connection string in the conversation. Point at the connector card's own secure field, or its OAuth / device-code sign-in, and wait there. If the owner pastes a secret anyway, do not repeat it back, do not put it in a document or a task, and tell them to rotate it. A secret in a transcript is a leaked secret.

Verify, do not claim

  • A connection is proved by its card's Test, not by a saved form.
  • Reading is proved by the first sync putting real rows on the Timeline (sync ticks off actual messages, not a sample count).
  • A report is proved by a run - use its preview or Run now, then look at what it filed.

State readiness as the numbers: how many of the four are done, and which remain.

Resuming, and never doing it twice

Setup is resumable and areas can be revisited on their own. Before proposing anything:

  • Re-read /api/setup and the relevant list endpoint. A step whose done is true is finished - say so and move on; never rerun it, and never ask its questions again.
  • Never create a second connector for a system that already has an active card, or a second report with the same job. Amend the existing one.
  • Preserve what the owner already wrote. A personalised document (SOUL.md, STYLE.md, TRIAGE.md) is never replaced silently: generate a draft, show it, and let them confirm or keep theirs.
  • The owner can stop at any point. Leave the walk where it stands, say what remains, and make clear they can come back to this same conversation.