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

truecourse-list

GitHub

通过npx运行TrueCourse工具，列出仓库中的代码违规项。支持全量或差异模式，提供分页、严重性过滤及修复建议，避免一次性输出过多内容。

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

Trigger Scenarios

用户请求查看代码违规列表用户希望分析仓库安全问题

Install

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

More Options

Non-standard path

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

Use without installing

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).