## 08 项目专用 LLM 提示词库

本页提供“可直接复制使用”的高质量提示，帮助你让 LLM 快速产出可用结果并符合本仓库规范。

### A. 代码阅读与摘要

```
请用项目的术语解释以下文件的职责、关键数据结构与调用关系，并输出：
- 模块职责一句话
- 关键输入/输出列表
- 依赖关系（指向文件/类/函数名）
- 可能的风险点（异常、边界、安全）
文件：{path}
```

### B. 代码修改（小粒度）

```
目标：在不改变对外行为的前提下，给 {path} 增加类型注解并通过 mypy 严格模式。
要求：
- 仅增补类型/导入/最小逻辑护栏，不改动核心算法
- 用精准的 # type: ignore[code] 解决复杂问题
- 变更后运行：mypy、ruff、pytest 均应通过
```

### C. 新语言插件脚手架

```
为新语言 {lang} 创建插件原型，遵循现有插件模式：
- 在 languages/ 下创建 {lang}_plugin.py
- 注册 entry point
- 最小实现 analyze() 返回类/方法/字段结构
- 补一个最小 e2e 测试样例（tests/ 下）
完成后给出：文件清单、关键代码片段与运行指令
```

### D. 故障定位

```
以下命令输出异常，请定位根因并给出最小修复：
命令：{cmd}
日志/堆栈：{logs}
输出：
- 问题归因
- 涉及文件/函数
- 最小可行修复（不破坏既有测试）
- 本地验证步骤
```

### E. 文档生成

```
根据 {path} 源码，生成对外 README 片段（中文），包含：
- 使用场景
- API/CLI 示例
- 约束与注意事项
风格与语调保持与仓库 README_zh.md 一致。
```




