菜单
Uses bd (beads) for issue tracking. Use when finding work, claiming or closing issues, syncing with git, or when the user mentions bd, beads, issues, or tasks.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Load this skill when you need to understand or preserve fastWorkflow's load-bearing runtime design before changing core code: anything touching WorkflowExecutionContext, ChatSession, the CME/wildcard NLU pipeline, ask_user suspension/resume, AskUserSuspend / CommandCancelledError, SessionStateStore, TurnResult/TurnOutput/process_turn, the TurnRegistry turns engine, context models, or session serialization. Trigger phrases: "why is this a BaseException", "Topology A vs Topology B", "where does the turn get finalized", "is it safe to run two turns on one channel", "what breaks if I rename a command", "what is the cme workflow", "context_hierarchy_model". Do NOT load it for step-by-step debugging of a failure (use fastworkflow-debugging-playbook), for running the server/CLI (fastworkflow-run-and-operate), for model/threshold details of the NLU stack (fastworkflow-nlu-pipeline-reference), or for env-var/flag lookups (fastworkflow-config-and-flags).
Load this skill when setting up the fastWorkflow dev environment from scratch or fixing a broken one: fresh clone, "which Python / poetry install / pip extras do I need", "tests are all skipping", "FileNotFoundError threshold.json", "make gen-env fails", "where do API keys go", "env/.env vs passwords/.env vs fastworkflow.env", or re-provisioning after the hello_world model was wiped. Do NOT load it for running/operating workflows (fastworkflow-run-and-operate), the full env-var catalog (fastworkflow-config-and-flags), test-writing policy (fastworkflow-validation-and-qa), or debugging runtime failures (fastworkflow-debugging-playbook).
Load this skill BEFORE making any change to the fastWorkflow repo that touches git, beads (bd), version numbers, tests, or documents in docs/. Triggers: "commit this", "push", "bump the version", "close the issue", "bd create/update/close", "delete this test", "clean up docs/", "should this get a design doc?", "is this a patch or a minor?", "can I commit the skills library?". Also load when you see symptoms like a bd close that didn't stick, an epic that looks shipped but shows open, or untracked team-private docs in git status. Do NOT load for debugging runtime failures (use fastworkflow-debugging-playbook), for running/operating the app (fastworkflow-run-and-operate), or for how-to-test mechanics (fastworkflow-validation-and-qa).
Load this skill whenever you touch fastWorkflow configuration: any LLM_* / LITELLM_API_KEY_* / SPEEDDICT_FOLDERNAME / INTENT_DETECTION_* / SESSION_STATE_* env var, the fastworkflow.env or fastworkflow.passwords.env files, a fastworkflow CLI subcommand or flag, LiteLLM proxy routing, or JWT server settings. Trigger symptoms: "env var not found" warnings, "SPEEDDICT_FOLDERNAME env var not found!", "DSPy Language Model not provided", shell exports being mysteriously ignored, refine failing with a missing-LM ValueError, or needing to add a new config knob. Do NOT use it for how to run/operate workflows end to end (fastworkflow-run-and-operate), recreating the dev environment and secrets (fastworkflow-build-and-env), or debugging non-config runtime failures (fastworkflow-debugging-playbook).
Symptom-to-triage playbook for fastWorkflow runtime, build, and train failures. Load this when you see: the wrong command being matched, "threshold.json not found" / FileNotFoundError in ___command_info, the internal CME workflow retraining on every `fastworkflow train`, parameter extraction looping on NOT_FOUND, the CLI hanging or never printing an agent question, FastAPI 409/202 surprises or "poll /turns" advice, DeprecationWarning about process_message, commands with too few training utterances, stale/frozen LLM outputs (DSPy cache), RocksDB/speedict lock errors, env vars that "don't take effect", or tests that mysteriously pass/fail/skip. Do NOT load this for writing new tests (fastworkflow-validation-and-qa), env-var reference (fastworkflow-config-and-flags), historical post-mortems (fastworkflow-failure-archaeology), or tau2 benchmark work (tau2-reliability-campaign).
Load this skill when you need to MEASURE a fastWorkflow workflow instead of eyeballing it — inspect ___command_info trained artifacts, check whether cached command snapshots are stale (fingerprint FRESH/STALE), capture or read a turn's command traces / action.jsonl, smoke-test intent-classifier accuracy, configure LOG_LEVEL, inspect the DSPy LLM cache, or hit the server probe endpoints. Trigger phrases/symptoms: "why did it rebuild", "is this workflow trained", "what did the agent actually do", "traces are empty", "stale cache", "threshold.json", "confusion between commands", "cache hit hides the LLM call". Do NOT load for diagnosing a specific failure end-to-end (use fastworkflow-debugging-playbook), for NLU/model theory (use fastworkflow-nlu-pipeline-reference), or for statistics like pass^k variance (use fastworkflow-proof-and-analysis-toolkit).
| name | beads-workflow |
| description | Uses bd (beads) for issue tracking. Use when finding work, claiming or closing issues, syncing with git, or when the user mentions bd, beads, issues, or tasks. |
This project uses Beads (bd) for issue tracking.
bd ready to find available work.bd create to track new issues/tasks/bugs.bd sync at end of session to sync with git remote.bd onboard # Get started / load workflow context
bd prime # Load complete workflow docs (AI-optimized)
bd ready # Show issues ready to work (no blockers)
bd list --status=open # List all open issues
bd create --title="..." --type=task # Create new issue
bd show <id> # View issue details
bd update <id> --status=in_progress # Claim work
bd close <id> # Mark complete
bd dep add <issue> <depends-on> # Add dependency
bd sync # Sync with git remote
bd readybd update <id> --status=in_progressbd close <id>bd sync (or let git hooks handle it)bd onboardbd prime for AI-optimized context (~1–2k tokens)For more: see AGENTS.md or bd --help.