Agent skill

Log Config Debugging

by SurveyController in SurveyController/SurveyController

面向 SurveyController 的日志、配置与报错排查技能。用于根据用户提供的日志、截图、配置文件、调用栈、运行环境和最近改动定位根因,修复 software/app/、software/io/、software/logging/、software/network/、software/ui/…

GPL-3.0Auto-check passedDevelopment

Install Log Config Debugging

skills CLI
$ npx skills add SurveyController/SurveyController --skill log-config-debugging -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install SurveyController/SurveyController log-config-debugging --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/SurveyController/SurveyController.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.codex/skills/log-config-debugging .claude/skills/log-config-debugging && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
log-config-debugging
GitHub stars
142
Token cost
~481 tokens
SKILL.md length
81 words
Files
1
Skills in repo
9
Repo updated
First seen
Licence
GPL-3.0

At a glance

面向 SurveyController 的日志、配置与报错排查技能。用于根据用户提供的日志、截图、配置文件、调用栈、运行环境和最近改动定位根因,修复 software/app/、software/io/、software/logging/、software/network/、software/ui/…

  • Works in 6 steps: 先收集现场。 → 先定根因,再决定改哪层。 → 涉及配置时,保持兼容。 → …
  • Tasks that involve Debugging
  • SKILL.md covers name, description, when_to_use and instructions, plus 3 more sections
  • Calls uv and rg

What it does

Log Config Debugging is an agent skill from SurveyController/SurveyController. 面向 SurveyController 的日志、配置与报错排查技能。用于根据用户提供的日志、截图、配置文件、调用栈、运行环境和最近改动定位根因,修复 software/app/、software/io/、software/logging/、software/network/、software/ui/ 以及平台适配层中的配置兼容、路径、编码、权限、依赖版本和平台差异问题。适合处理真实报错和配置脱节,不适合只改表面提示词。

Its SKILL.md is about 480 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Development, covering Debugging. The repository describes itself as: 适用于问卷星、腾讯问卷、Credamo见数平台的纯HTTP高并发提交程序. The licence is GPL-3.0.

When your agent uses it

  • Tasks that involve Debugging

Example prompts

  • “/log-config-debugging”

Requirements

  • Python 3

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. 先收集现场。
  2. 先定根因,再决定改哪层。
  3. 涉及配置时,保持兼容。
  4. 修复时重点排查
  5. 日志只记录必要信息。
  6. 改完后给出可复现步骤和验证命令。

What it can do on your machine

Read from SKILL.md and the folder at commit 1a22ba3. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv
    • rg

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Log Config Debugging loads about 481 tokens when it runs. Until then it costs about 58 tokens; SKILL.md has 81 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~58
When it runs · the whole SKILL.md, loaded when a task matches
~481

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from SurveyController/SurveyController at commit 1a22ba3, republished under its GPL-3.0 licence (© SurveyController). 81 words, ~481 tokens.

Download SKILL.mdSave it as .claude/skills/log-config-debugging/SKILL.md (or your agent's skills folder).
name
log-config-debugging
description
面向 SurveyController 的日志、配置与报错排查技能。用于根据用户提供的日志、截图、配置文件、调用栈、运行环境和最近改动定位根因,修复 software/app/、software/io/、software/logging/、software/network/、software/ui/ 以及平台适配层中的配置兼容、路径、编码、权限、依赖版本和平台差异问题。适合处理真实报错和配置脱节,不适合只改表面提示词。

log-config-debugging

name

log-config-debugging

description

这个 skill 处理日志、配置和报错排查。 重点是先找根因,再修代码,再验证。 不是只给报错糊个补丁。

when_to_use

出现这些情况时用:

  • 用户给了日志、截图、配置文件、报错堆栈,要定位问题。
  • 配置兼容性出毛病,旧配置升级后炸了。
  • 路径、编码、权限、依赖版本、平台差异导致运行异常。
  • UI 显示和实际配置脱节,日志里看不清根因。

这些情况别偷懒:

  • 只改提示文案,不修根因。
  • 在日志里打印敏感配置、token、cookie、代理密钥。

instructions

  1. 先收集现场。 必看:
    • 错误信息
    • 调用栈
    • 用户配置文件
    • 运行环境
    • 最近改动
  2. 先定根因,再决定改哪层。 常见落点:
    • software/app/ 路径、设置、迁移
    • software/logging/ 日志初始化和格式
    • software/io/ 配置读写、导入导出
    • software/network/ HTTP、代理、会话
    • software/ui/ 配置同步和错误反馈
  3. 涉及配置时,保持兼容。 优先考虑迁移、默认值、缺省字段补齐。 相关路径先看 software/app/user_paths.py。
  4. 修复时重点排查:
    • 路径拼错
    • 编码不一致
    • 文件权限
    • 依赖版本
    • Windows 与其他平台差异
  5. 日志只记录必要信息。 敏感字段要脱敏。
  6. 改完后给出可复现步骤和验证命令。 如果用户还要自查,再补最少量排查命令。

project_conventions

  • 用户可写配置和日志目录不在仓库根目录,真实入口看 software/app/user_paths.py。
  • configs/ 在当前工作区可直接读取做真实提交回归,但不要把敏感数据写回仓库。
  • 日志工具主要在 software/logging/log_utils.py、software/logging/action_logger.py。
  • 配置和路径问题优先修根因,不要只在 UI 上盖个提示。
  • 普通单测不要访问真实外部服务,live 回归放 CI/live_tests/。

common_commands

bash
uv run python CI/python_ci.py
uv run pytest CI/unit_tests/app
uv run pytest CI/unit_tests/test_log_utils.py
uv run pytest CI/unit_tests/test_log_utils_concurrency.py
uv run pytest CI/unit_tests/test_submission_report.py
uv run pytest CI/unit_tests/test_system_helpers.py
rg "config|settings|log|path|encoding|json|traceback|exception" software CI/unit_tests

validation_checklist

  • 是否先看了错误信息、调用栈、配置文件、环境和最近改动。
  • 是否找到根因,而不是只改表面报错。
  • 对旧配置是否保持兼容;需要迁移时是否补了迁移或默认值。
  • 路径、编码、权限、依赖版本、平台差异是否排查过。
  • 日志里是否没有泄露敏感信息。
  • 是否整理了复现步骤、修复点、验证命令和用户可执行的排查命令。

© SurveyController, GPL-3.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in .codex/skills/log-config-debugging of SurveyController/SurveyController.

Open the folder on GitHubat commit 1a22ba3

Compare with similar skills

Log Config Debugging next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Log Config Debugging compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Log Config Debugging this skillSurveyController/SurveyController142—~481Automated safety check: PassGPL-3.0
Trellis Session Insightmindfold-ai/Trellis15k4 repos~1.7kAutomated safety check: PassAGPL-3.0
Native Data FetchingCherryHQ/cherry-studio-app4k6 repos~2.9kAutomated safety check: NotesMIT
Aoti Debugpytorch/pytorch104k1 repos~1.7kAutomated safety check: PassCustom licence
Herdr Throwaway Reproductionherdrdev/herdr43k—~2.4kAutomated safety check: PassApache-2.0
Systematic Debuggingultralisp/ultralisp25851 repos~2.4kAutomated safety check: PassNone

Similar skills

  • Trellis Session Insight

    mindfold-ai/Trellis

    Reach into past AI conversation history through the trellis mem CLI.

    15k GitHub starsUsed in 4 repos~1.7k tokens
    DevelopmentAuto-check passed
  • Native Data Fetching

    CherryHQ/cherry-studio-app

    A skill your agent uses when implementing or debugging ANY network request, API call, or data fetching.

    4k GitHub starsUsed in 6 repos~2.9k tokens
    DevelopmentAuto-check: notes
  • Aoti Debug

    pytorch/pytorch

    Debug AOTInductor (AOTI) errors and crashes. An agent skill from pytorch/pytorch.

    104k GitHub starsUsed in 1 repo~1.7k tokens
    DevelopmentAuto-check passed
  • Runs a disposable, uniquely named Herdr session inside an existing one so runtime, pane, terminal or API bugs can be reproduced without touching the main session.

    43k GitHub stars~2.4k tokensUpdated yesterday
    DevelopmentAuto-check passed
  • Systematic Debugging

    ultralisp/ultralisp

    A skill your agent uses when encountering any bug, test failure, or unexpected behavior, before proposing fixes

    258 GitHub starsUsed in 51 repos~2.4k tokens
    DevelopmentAuto-check passed
  • Decides whether an OpenLogi device problem on macOS is a privacy-permission (TCC) problem, using agent log lines, and says which identity needs which grant.

    23k GitHub stars~2.5k tokensUpdated 4 days ago
    DevelopmentAuto-check: notes

More from SurveyController/SurveyController

All 9 skills in this repo
  • App Settings Migration

    SurveyController/SurveyController

    面向 SurveyController 仓库的设置、路径与配置迁移技能。用于修改 software/app/、software/io/config/、software/core/config/ 里的 QSettings 键、用户目录、配置文件路径、schema 版本、序列化字段、默认值和兼容策略,避免升级后读错配置、写错目录或把旧配置直接干爆。适合做预防性演进,不适合只修表面报错。

    142 GitHub stars~732 tokensUpdated 19 days ago
    Auto-check passed
  • Async HTTP Pipeline

    SurveyController/SurveyController

    面向 SurveyController 仓库的全异步 HTTP 解析与执行链路技能。用于修改或排查 software/network/http/、software/core/engine/、software/providers/、software/network/proxy/ 以及各平台 provider 的异步请求、响应解析、任务调度、并发控制、超时、重试、取消和资源释放问题。适合处理纯…

    142 GitHub stars~648 tokensUpdated 19 days ago
    Auto-check passed
  • Gui Development

    SurveyController/SurveyController

    面向 SurveyController 桌面端的 GUI 开发与界面修复技能。用于修改 software/ui/ 下的 PySide6 + QFluentWidgets 页面、弹窗、导航、配置编辑、运行状态展示和日志界面,处理信号槽、线程协作、对象生命周期、布局、主题和窗口缩放问题。适合做桌面界面开发、交互修复和配置同步,不适合把耗时逻辑直接塞进主线程。

    142 GitHub stars~580 tokensUpdated 19 days ago
    Auto-check passed
  • Playwright Pipeline

    SurveyController/SurveyController

    面向 SurveyController 仓库 v3 分支的 Playwright 作答执行层技能。仅在修改或排查 Playwright 作答链路、异步浏览器 owner/context 池、BrowserDriver 封装、页面加载、运行时答题、翻页、提交、取消、超时、资源释放和并发调度时使用。只能用于 v3 分支;只允许系统自带 Microsoft Edge,不允许安装或引入…

    142 GitHub stars~945 tokensUpdated 19 days ago
    Auto-check passed
  • Question Parser Rules

    SurveyController/SurveyController

    面向 SurveyController 仓库的题型解析、字段映射与 parser 规则技能。用于修改 wjx/provider/、tencent/provider/、credamo/provider/、software/core/questions/、software/providers/ 中的题目结构解析、元数据字段、题型识别、逻辑规则标记、答案模型映射和最小兼容适配。适合处理 parser…

    142 GitHub stars~653 tokensUpdated 19 days ago
    Auto-check passed
  • Structure Refactor

    SurveyController/SurveyController

    面向 SurveyController 仓库的目录结构重构与模块拆分技能。用于整理 software/、wjx/、tencent/、credamo/、CI/unittests/ 等真实目录,处理文件移动、命名调整、导入修复、测试路径更新、资源路径修复、CI 检查联动。适合在需要小步重构、保持行为不变、清理屎山边界时使用,不适合纯样式改名或无关大洗牌。

    142 GitHub stars~645 tokensUpdated 19 days ago
    Auto-check passed

Categories

Questions about Log Config Debugging

What does Log Config Debugging do?

面向 SurveyController 的日志、配置与报错排查技能。用于根据用户提供的日志、截图、配置文件、调用栈、运行环境和最近改动定位根因,修复 software/app/、software/io/、software/logging/、software/network/、software/ui/…. Log Config Debugging is an agent skill from SurveyController/SurveyController.

When should I use Log Config Debugging?

Log Config Debugging fits situations like: tasks that involve Debugging.

How do I install Log Config Debugging in Claude Code?

Run `npx skills add SurveyController/SurveyController --skill log-config-debugging -a claude-code`. Or copy the skill folder (.codex/skills/log-config-debugging in SurveyController/SurveyController) into .claude/skills/log-config-debugging in your project. Claude Code loads it when a task matches its description.

How do I install Log Config Debugging in Codex?

Run `npx skills add SurveyController/SurveyController --skill log-config-debugging -a codex`. Or copy the skill folder (.codex/skills/log-config-debugging in SurveyController/SurveyController) into .agents/skills/log-config-debugging in your project. Codex loads it when a task matches its description.

Can I use Log Config Debugging in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add SurveyController/SurveyController --skill log-config-debugging -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/log-config-debugging, .gemini/skills/log-config-debugging, .github/skills/log-config-debugging and .opencode/skills/log-config-debugging in your project.

What does Log Config Debugging need to run?

Going by SKILL.md and its folder, Log Config Debugging needs the command-line tools its instructions call (uv and rg). Our summary lists: Python 3.

Does Log Config Debugging access the network?

SKILL.md contains no URLs. Its commands use uv, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Log Config Debugging safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Log Config Debugging use?

Log Config Debugging is published under the GPL-3.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Log Config Debugging use?

About 481 tokens (SKILL.md is roughly 1.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Log Config Debugging?

Skills that share tags, products or a category with Log Config Debugging: Trellis Session Insight (mindfold-ai/Trellis, 15k stars), Native Data Fetching (CherryHQ/cherry-studio-app, 4k stars), Aoti Debug (pytorch/pytorch, 104k stars) and Herdr Throwaway Reproduction (herdrdev/herdr, 43k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Log Config Debugging?

SurveyController (a GitHub organization) maintains it in SurveyController/SurveyController, which has 142 GitHub stars. The repository holds 9 skills in this directory. The repository was last updated on September 18, 2026.

Source: SurveyController/SurveyController on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.