Agent skill

Question Parser Rules

by SurveyController in SurveyController/SurveyController

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

GPL-3.0Auto-check passedTesting & QA

Install Question Parser Rules

skills CLI
$ npx skills add SurveyController/SurveyController --skill question-parser-rules -a claude-code

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

GitHub CLI
$ gh skill install SurveyController/SurveyController question-parser-rules --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/question-parser-rules .claude/skills/question-parser-rules && 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
question-parser-rules
GitHub stars
142
Token cost
~653 tokens
SKILL.md length
121 words
Files
2
Skills in repo
9
Repo updated
First seen
Licence
GPL-3.0

At a glance

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

  • Works in 5 steps: 先定范围。 → 先抓事实,再改规则。 → 找落点。 → …
  • Testing & QA work in your project
  • SKILL.md covers must_read, workflow, field_rules and boundaries, plus 2 more sections
  • Calls uv and rg

What it does

Question Parser Rules is an agent skill from SurveyController/SurveyController. 面向 SurveyController 仓库的题型解析、字段映射与 parser 规则技能。用于修改 wjx/provider/、tencent/provider/、credamo/provider/、software/core/questions/、software/providers/ 中的题目结构解析、元数据字段、题型识别、逻辑规则标记、答案模型映射和最小兼容适配。适合处理 parser 规则和题目结构演进,不适合处理 HTTP 提交调度或纯接口逆向分析。

Its SKILL.md is about 650 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

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

When your agent uses it

  • Testing & QA work in your project

Example prompts

  • “/question-parser-rules”

Requirements

  • Python 3

Workflow steps

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

  1. 先定范围。
  2. 先抓事实,再改规则。
  3. 找落点。
  4. 最小改动适配。
  5. 如果 parser 输出字段变了,顺手检查消费方。

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

Question Parser Rules loads about 653 tokens when it runs. Until then it costs about 66 tokens; SKILL.md has 121 words of instructions outside code blocks.

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

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). 121 words, ~653 tokens.

Download SKILL.mdSave it as .claude/skills/question-parser-rules/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
question-parser-rules
description
面向 SurveyController 仓库的题型解析、字段映射与 parser 规则技能。用于修改 `wjx/provider/`、`tencent/provider/`、`credamo/provider/`、`software/core/questions/`、`software/providers/` 中的题目结构解析、元数据字段、题型识别、逻辑规则标记、答案模型映射和最小兼容适配。适合处理 parser 规则和题目结构演进,不适合处理 HTTP 提交调度或纯接口逆向分析。

Question Parser Rules

这个 skill 处理“题目怎么被识别、落成什么字段、后面怎么用”。 重点是 parser 输出结构稳定,平台隔离清楚,别把题型判断和执行链路搅成屎。

must_read

  • software/providers/contracts.py
  • software/core/questions/config.py
  • software/core/questions/schema.py
  • software/core/questions/validation.py
  • 目标平台的 parser.py
  • 目标平台的 answering_builders.py 或相关 helper
  • 对应测试文件

workflow

  1. 先定范围。
    • 入口页/接口字段变了
    • 题型识别错了
    • option、row、text_inputs、逻辑规则字段错了
    • parser 输出对了,但后续答案构造跟不上
  2. 先抓事实,再改规则。
    • HTML 片段
    • JSON payload
    • 现有 parser 输出
    • 失败日志
  3. 找落点。
    • 平台专属解析:各自 */provider/parser.py
    • 平台专属 helper:平台目录下的辅助模块
    • 通用题目字段和约束:software/core/questions/
    • 通用问卷元数据契约:software/providers/contracts.py
  4. 最小改动适配。
    • 先补具体题型规则
    • 再看要不要抽公共 helper
    • 没必要别顺手重写整个 parser
  5. 如果 parser 输出字段变了,顺手检查消费方。
    • UI 问题编辑器
    • provider answering builders
    • runtime preparation

field_rules

改 parser 时重点盯这些字段:

  • type_code
  • option_texts
  • rows、row_texts
  • text_inputs、text_input_labels
  • fillable_options
  • attached_option_selects
  • is_location
  • is_rating
  • multi_min_limit、multi_max_limit
  • has_jump、jump_rules
  • has_display_condition、display_conditions
  • has_dependent_display_logic、controls_display_targets
  • logic_parse_status
  • provider、provider_question_id、provider_page_id、provider_type

这些字段不是随便加着玩的。 一旦语义变了,UI、执行链路、反填和答案构造都可能跟着炸。

boundaries

  1. 平台差异留在各自目录。
    • wjx/provider/
    • tencent/provider/
    • credamo/provider/
  2. 通用层不要出现平台私货字段判断。
  3. 题型解析和 HTTP 调度分开。 提交并发、超时、重试去 async-http-pipeline。
  4. 接口事实提取和签名字段归类优先走 survey-platform-reverse-analysis。 这个 skill 只负责把题目结构落成项目内部可消费的数据。

common_commands

bash
uv run pytest CI/unit_tests/providers
uv run pytest CI/unit_tests/questions
uv run pytest CI/unit_tests/providers/test_http_runtime.py
uv run pytest CI/unit_tests/engine/test_provider_common.py
uv run pytest CI/unit_tests/engine/test_reverse_fill_parser.py
uv run python CI/python_ci.py
rg "type_code|logic_parse_status|provider_question_id|option_texts|row_texts|fillable_options" wjx tencent credamo software/core software/providers

validation_checklist

  • 是否先拿到了 HTML、接口 payload 或失败日志,而不是瞎猜。
  • 规则改动是否落在对应平台目录,没有把平台脏活抹进通用层。
  • parser 输出字段语义是否和现有契约一致。
  • 改了字段后,消费方是否一起看过。
  • 是否优先补了 provider 和 questions 测试。
  • 如果只是某个平台新增小规则,是否避免了无关重构。

© 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

SKILL.md and 1 other file in .codex/skills/question-parser-rules of SurveyController/SurveyController.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 1a22ba3

Compare with similar skills

Question Parser Rules 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.

Question Parser Rules compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Question Parser Rules this skillSurveyController/SurveyController142—~653Automated safety check: PassGPL-3.0
Web Application Testinganthropics/skills180k51 repos~966Automated safety check: PassApache-2.0
Diagnosing Bugsfossasia/eventyay-interpretation1.6k32 repos~2.1kAutomated safety check: PassApache-2.0
TDDpietheinstrengholt/rssmonster56430 repos~906Automated safety check: PassMIT
TDD WorkflowhellangleZ/burn-in-cceverywhere-ralph11211 repos~2.4kAutomated safety check: PassNone
TDDsanity-io/sanity6.4k20 repos~1kAutomated safety check: PassMIT

Similar skills

  • Web Application Testing

    anthropics/skills

    Official

    Tests local web applications with Python Playwright scripts, checking frontend behavior, capturing screenshots and reading browser console logs.

    180k GitHub starsUsed in 51 repos~966 tokens
    Testing & QAAuto-check passed
  • Diagnosing Bugs

    fossasia/eventyay-interpretation

    Diagnosis loop for hard bugs and performance regressions. An agent skill from fossasia/eventyay-interpretation.

    1.6k GitHub starsUsed in 32 repos~2.1k tokens
    Testing & QAAuto-check passed
  • TDD

    pietheinstrengholt/rssmonster

    Test-driven development. An agent skill from pietheinstrengholt/rssmonster.

    564 GitHub starsUsed in 30 repos~906 tokens
    Testing & QAAuto-check passed
  • TDD Workflow

    hellangleZ/burn-in-cceverywhere-ralph

    A skill your agent uses when writing new features, fixing bugs, or refactoring code.

    112 GitHub starsUsed in 11 repos~2.4k tokens
    Testing & QAAuto-check passed
  • TDD

    sanity-io/sanity

    Official

    Test-driven development with red-green-refactor loop. An agent skill from sanity-io/sanity.

    6.4k GitHub starsUsed in 20 repos~1k tokens
    Testing & QAAuto-check passed
  • Context Driven Development

    Ibrahim-3d/orchestrator-supaconductor

    A skill your agent uses when working with Conductor's context-driven development methodology, managing project context artifacts, or understanding the relationship between product.md, tech-stack.md…

    380 GitHub starsUsed in 9 repos~2.9k tokens
    Testing & QAAuto-check passed

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 20 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 20 days ago
    Auto-check passed
  • Gui Development

    SurveyController/SurveyController

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

    142 GitHub stars~580 tokensUpdated 20 days ago
    Auto-check passed
  • Log Config Debugging

    SurveyController/SurveyController

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

    142 GitHub stars~481 tokensUpdated 20 days ago
    Auto-check passed
  • Playwright Pipeline

    SurveyController/SurveyController

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

    142 GitHub stars~945 tokensUpdated 20 days ago
    Auto-check passed
  • Structure Refactor

    SurveyController/SurveyController

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

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

Categories

Questions about Question Parser Rules

What does Question Parser Rules do?

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

When should I use Question Parser Rules?

Question Parser Rules fits situations like: testing & QA work in your project.

How do I install Question Parser Rules in Claude Code?

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

How do I install Question Parser Rules in Codex?

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

Can I use Question Parser Rules 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 question-parser-rules -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/question-parser-rules, .gemini/skills/question-parser-rules, .github/skills/question-parser-rules and .opencode/skills/question-parser-rules in your project.

What does Question Parser Rules need to run?

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

Does Question Parser Rules 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 Question Parser Rules 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 Question Parser Rules use?

Question Parser Rules 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 Question Parser Rules use?

About 653 tokens (SKILL.md is roughly 2.6k 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 Question Parser Rules?

Skills that share tags, products or a category with Question Parser Rules: Web Application Testing (anthropics/skills, 180k stars), Diagnosing Bugs (fossasia/eventyay-interpretation, 1.6k stars), TDD (pietheinstrengholt/rssmonster, 564 stars) and TDD Workflow (hellangleZ/burn-in-cceverywhere-ralph, 112 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Question Parser Rules?

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.