fft-debug
- Repo stars 0
- Author updated Live
- Author repo nano-core
- Domain
- Engineering
- Compatible agents
-
- Claude Code
- Cursor
- Cline
- Codex
- Windsurf
- Gemini CLI
- +20
- Trust score
- 88 / 100 · community maintained
- Author / version / license
- @0-CYBERDYNE-SYSTEMS-0 · no license declared
- Token usage
- Lean
- Setup complexity
- Guided setup
- External API key
- Not required
- Operating systems
- Docker
- Runtime requirements
- Docker
- Permissions
-
- Read-only
- Write / modify
- Network behavior
- Local-only
- Install commands
- 26 variants
Profile is derived at build time from SKILL.md and install vectors. Subject to drift from author intent.
Heads up: 未限定 allowed-tools,默认拥有全部工具权限。
---
name: fft-debug
description: Diagnose and resolve FFT_nano runtime issues across container execution, provider credentials, T…
category: engineering
runtime: Docker
---
# fft-debug output preview
## PART A: Task fit
- Use case: Diagnose and resolve FFT_nano runtime issues across container execution, provider credentials, Telegram/WhatsApp routing, scheduler behavior, and per-group logs/state. Use when runtime behavior is failing, degraded, or inconsistent. runs entirely locally; runs on Docker. Works with Claude Code, Cursor, Cline and 23 more..
- Inputs: target material, constraints, expected output, and acceptance criteria.
- Evidence boundary: follow “When to use this skill / When not to use this skill / Guardrails” and do not present inference as author intent.
## PART B: Execution result
- **01** The card summarizes the use case; runtime output centers on “Diagnose and resolve FFT_nano runtime issues across container execution, provider credentials, Telegram/WhatsApp routing, scheduler behavior, and per-group logs/state. Use when runtime behavior is failing, degraded, or inconsistent. runs entirely locally; runs on Docker. Works with Claude Code, Cursor, Cline and 23 more.”.
- **02** When the source has headings, the agent prioritizes “When to use this skill / When not to use this skill / Guardrails” so the result follows the author’s structure.
- **03** Typical output includes task judgment, concrete steps, required commands or file edits, validation, and follow-up options.
- **04** Risk context follows the fingerprint: read files, write/modify files; mostly runs locally; usually needs no extra API key.
## Running Rules
- read files, write/modify files; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding scope.
- Return the result, validation criteria, and next iteration options. The source mentions slash commands such as `/id`, `/status`, `/help`, `/tasks`, `/groups`; use them first when your agent supports command triggers.
Name target files or source material, expected output, forbidden changes, and whether network or shell access is allowed. Permission fingerprint: read files, write/modify files.
Start with a small task and check whether the result follows “When to use this skill / When not to use this skill / Guardrails”. Inspect diffs, logs, previews, or tests before expanding scope.
Confirm the final output includes a concrete result, evidence, and next action. If it stays generic, tighten inputs, boundaries, and acceptance criteria.
---
name: fft-debug
description: Diagnose and resolve FFT_nano runtime issues across container execution, provider credentials, T…
category: engineering
source: 0-CYBERDYNE-SYSTEMS-0/nano-core
---
# fft-debug
## When to use
- Diagnose and resolve FFT_nano runtime issues across container execution, provider credentials, Telegram/WhatsApp routi…
- Use it when the task has clear inputs, repeatable steps, and validation criteria.
## What to provide
- Target material, scope, expected result, and forbidden changes.
- Whether network, commands, file writes, or external services are allowed.
## Execution rules
- Organize steps around “When to use this skill / When not to use this skill / Guardrails” and keep inference separate from source facts.
- read files, write/modify files; mostly runs locally; usually needs no extra API key.
- Validate with a small sample before expanding the task.
## Output requirements
- Return the deliverable, key evidence, validation method, and next action.
- Mark missing information as unknown; do not invent commands, platforms, or dependencies. The author source anchors workflow facts; repository files anchor sources and commands; Fluxly only adds fit, limitations, and quality judgment.
skill "fft-debug" {
input -> user goal + target files + boundaries + acceptance criteria
context -> When to use this skill / When not to use this skill / Guardrails
rules -> SKILL.md triggers / order / output contract
runtime -> Docker | read files, write/modify files | mostly runs locally
guardrails -> usually needs no extra API key + small-sample validation + diff/log review
output -> copyable result + checklist + next iteration
} FFT Debug
Use this skill for incident triage and deterministic debugging of FFT_nano host and container paths.
When to use this skill
- Use when runtime behavior is failing, degraded, or inconsistent.
- Use when investigating provider wiring, routing, logs, or IPC state.
- Use when producing reproducible triage output before any fix attempt.
When not to use this skill
- Do not use as the default path for normal feature work.
- Do not use when the request is purely product behavior, not incident/debug.
- Do not use to justify destructive cleanup without explicit approval.
Guardrails
- Never use destructive git commands unless explicitly requested.
- Preserve unrelated worktree changes.
- Keep admin/coder controls in main chat only; do not bypass main-chat restrictions.
Fast Triage
- Confirm single instance lock:
ls -la data/fft_nano.lock
- Check startup/runtime logs:
tail -n 200 logs/fft_nano.logtail -n 200 logs/fft_nano.error.log
- Check per-group container logs:
ls -la groups/<group>/logstail -n 200 groups/<group>/logs/*
- Inspect registration + IPC state:
cat data/registered_groups.jsonfind data/ipc -maxdepth 3 -type f
Common Failure Modes
- Provider key missing: Pi reports no models available.
- Wrong
PI_API/PI_MODEL: model/provider not found. - Multiple bot instances: Telegram getUpdates conflict.
- Docker daemon unavailable or runtime permission issues.
Recommended Debug Commands
- Build/runtime checks:
npm run typechecknpm test
- Dry-run routing check (no live model call):
FFT_NANO_DRY_RUN=1 ./scripts/start.sh dev telegram-only
- Runtime detail logging:
LOG_LEVEL=debug ./scripts/start.sh dev telegram-only
Telegram Debug Path
- Verify bot token present at runtime.
- In bot DM:
/id,/status,/help. - Admin checks in main chat only:
/tasks,/groups,/panel,/coder,/coder-plan. - If
/main <secret>fails, verifyTELEGRAM_ADMIN_SECRETand restart.
Container Runtime Debug
- Docker runtime:
docker infodocker ps
- Host runtime (unisolated):
- verify explicit flags:
CONTAINER_RUNTIME=host,FFT_NANO_ALLOW_HOST_RUNTIME=1
- verify explicit flags:
Database/State Debug
- SQLite file location:
store/messages.db - Router state:
data/router_state.json - Group registry:
data/registered_groups.json - Per-group Pi state:
data/pi/<group>/.pi/
Decide Fit First
Design Intent
How To Use It
Boundaries And Review