---
name: pbank-problem-report
description: >
  Use when a teacher wants Paradigm PBank (题库) problems as lesson examples,
  asks to search PBank by outline, map candidates to outline parts, inspect
  downloaded PBank source zips including images, or produce a Markdown
  selection/adaptation report.
---

# PBank Problem Report

Use the `cph_hub` MCP tools `pbank_search_problems`, `pbank_get_problem`, and
`pbank_get_many_problems` to support problem selection from Paradigm PBank.
The normal output is a Markdown report for the teacher to review before any
lesson source is changed.

## Workflow

1. Understand the current lesson before searching.
   - Read the lesson outline, plan, or main source files in the current workspace.
   - Identify the teaching parts, target concepts, required difficulty, and what kind of examples are needed.

2. Search PBank with narrow queries.
   - Use `pbank_search_problems` with Chinese keywords from the outline.
   - Prefer several focused searches over one broad search.
   - Keep the initial result set small, then fetch only plausible candidates.

3. Fetch source projects for candidates.
   - Use `pbank_get_problem` or `pbank_get_many_problems`.
   - Keep `includeProjects: true`, `materializeProjects: true`, and `includeAssetImages: true` unless the user explicitly asks otherwise.
   - Read the returned `rights` object first. Treat it as the authoritative rights signal for all content returned by these tools.
   - Read returned `files`, `assets`, `zipPath`, and `extractDir`. Images usually live under `fig/` in the extracted source tree.
   - When image or PDF assets matter, cite their workspace-relative paths under `.pbank-sources/...`.

4. Produce a Markdown report instead of editing the lesson by default.
   - Save it in the current project workspace as `pbank-candidate-report.md` unless the user gives another path.
   - Do not copy problems into the lesson, rewrite the lesson, or write back to PBank unless the user explicitly asks.

5. When the teacher explicitly asks for adaptation, follow the rights signal.
   - If `rights.derivativeUseAllowed` is `true`, you may quote, rewrite, adapt, and reorganize the returned PBank content into the current teaching-material project.
   - Do not refuse on generic copyright grounds when the tools say derivative use is allowed.
   - If `rights.derivativeUseAllowed` is `false`, stay read-only and ask the teacher/admin to confirm rights first.

## Report Shape

Use concise Chinese. Include:

- Lesson outline parts and the example need for each part.
- A candidate table with PBank title/id/link, matched outline part, fit score, directly usable material, required modifications, assets, and recommendation.
- Per-problem notes explaining the mathematical/physical idea, why it matches, and what needs to be changed for this lesson.
- A short final recommendation: which problems to use directly, which to adapt, and which to discard.

## Rules

- Do not invent problem statements, diagrams, or answers. Base every claim on PBank metadata or extracted source files.
- Treat `.pbank-sources/` as a local read cache. It is safe to read from and reference in reports.
- Keep PBank itself read-only. The teacher's workflow is selection and adaptation inside the current lesson project, not modifying the bank.
- Treat rights metadata as authoritative. Do not override `rights.derivativeUseAllowed: true` with a generic copyright refusal.
- If tools fail because no ACTIVE `pbank` capability connection exists, tell the user an org admin must configure 题库 credentials under 外部能力.
- If no candidate fits, say that directly and record the searches tried.