Agent Skills › truecourse-ai/truecourse › truecourse-list

truecourse-list

GitHub

用于列出仓库中的 TrueCourse 违规项。支持全量或差异分析，默认分页展示前20条以节省上下文。提供按严重程度过滤、翻页及启动修复等后续操作选项。

tools/cli/skills/truecourse/truecourse-list/SKILL.md truecourse-ai/truecourse

触发场景

查询代码违规列表查看 TrueCourse 分析报告筛选特定严重程度的违规项

安装

npx skills add truecourse-ai/truecourse --skill truecourse-list -g -y

更多选项

非标准路径

npx skills add https://github.com/truecourse-ai/truecourse/tree/main/tools/cli/skills/truecourse/truecourse-list -g -y

不安装直接使用

npx skills use truecourse-ai/truecourse@truecourse-list

指定 Agent (Claude Code)

npx skills add truecourse-ai/truecourse --skill truecourse-list -a claude-code -g -y

安装 repo 全部 skill

npx skills add truecourse-ai/truecourse --all -g -y

预览 repo 内 skill

npx skills add truecourse-ai/truecourse --list

SKILL.md

Frontmatter

{
    "name": "truecourse-list",
    "triggers": [
        "show violations",
        "list issues",
        "what violations were found",
        "show diff results"
    ],
    "description": "List TrueCourse violations found in this repository",
    "user_invocable": true
}

TrueCourse List

Show violations and analysis results from TrueCourse.

Important

Always invoke via npx -y — without -y, npx will hang on the "Ok to proceed?" prompt whenever the user hasn't cached the latest truecourse version.
Don't dump everything at once. Plain list shows the first 20 violations — use that by default. Large repos can have hundreds; pasting them all wastes context and the user can't read that much in one go. Page or filter instead.

Instructions

1. Pick mode

Determine whether the user wants full violations (from the last full analysis) or diff results (changes since the last full analysis). If they said "diff" in their request, use diff mode.

Full: npx -y truecourse list
Diff: npx -y truecourse list --diff

2. Run and present

Use the Bash tool. The output is already formatted — show it as-is.

The final line summarises totals, e.g. Showing 1–20 of 287 violations (12 critical, 45 high, ...). Lead your reply with that total + severity breakdown so the user knows the scope before scanning the first page.

3. Offer the next step

After showing the first page, ask the user what they want:

Filter by severity — --severity <list>, e.g. --severity critical,high. Valid values: critical,high,medium,low,info.
Page further — use --offset <n> (next page is --offset 20, then --offset 40, …) or widen with --limit <n>.
Everything in one view — --all (only when the user explicitly asks for the full dump, e.g. "show all of them", "give me the whole list"). Avoid by default.
Start fixing — /truecourse-fix (only for violations with a Fix: block attached).