# Bishe Manual

> 用于撰写、补写、压缩、仿写、规范化交付中文毕业设计与毕业设计说明书（兼容课程设计说明书、技术报告）。用户提到毕业设计、毕设说明书、开题报告、任务书、学校模板、样文、参考文献、摘要、图表、截图、Word 成稿、查重口吻优化，或需要基于真实项目代码生成说明书正文时必须使用。内置样文结构学习、样式提取、章节控字、参考文献筛选、Mermaid/PlantUML 图表处理、Chrome MCP/Playwright 截图工作流与 doc/docx 成稿交付。

- **Type:** Skill
- **Install:** `agentstack add skill-however-yir-claude-skills-bishe-manual-skill`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [however-yir](https://agentstack.voostack.com/s/however-yir)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [however-yir](https://github.com/however-yir)
- **Source:** https://github.com/however-yir/claude-skills/tree/main/bishe-manual-skill

## Install

```sh
agentstack add skill-however-yir-claude-skills-bishe-manual-skill
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# BiShe Manual

## Overview

这个技能用于把“真实项目事实 + 样文/模板 + 文献约束 + 图表截图 + Word 成稿要求”稳定转化为可交付的《毕业设计说明书》。
目标不是把内容写厚，而是按样文体量、真实项目能力和版式规则，输出结构完整、字数可控、图表齐全的 `.docx` 成稿。

## Scope And Trigger

触发词（命中任一即触发）：

- 毕业设计
- 毕设说明书
- 毕业设计说明书
- 开题报告落稿
- 任务书转正文
- 说明书润色
- 查重降重
- 毕设答辩稿
- 基于项目代码生成说明书

排除词（命中时默认不触发本技能，除非用户明确要求）：

- 周报
- 日报
- 产品 PRD
- 运营文案
- 普通课程作业（非毕业设计）
- 新闻稿
- 社媒文案

冲突规则：

- 同时命中触发词和排除词时，先用一句话确认“是否进入毕业设计说明书流程”。

## Personal Defaults

以下为默认参数，除非用户明确覆盖：

| 参数 | 默认值 | 说明 |
|---|---|---|
| `direction_track` | `software_engineering` | 专业方向默认软件工程/计科应用型项目 |
| `doc_type` | `undergrad_bishe_manual` | 默认文种为“本科毕业设计说明书” |
| `advisor_preference` | `engineering_first` | 章节重实现、重模块、轻空泛理论 |
| `min_year` | `2020` | 参考文献默认最早年份 |
| `cn_count_range` | `10-12` | 中文文献默认数量区间 |
| `en_count_range` | `3-5` | 英文文献默认数量区间 |
| `reference_whitelist` | `CNKI, 万方, 维普, IEEE, ACM, Elsevier, Springer, MDPI` | 优先来源 |
| `reference_blacklist` | `不可核验网页, 无作者条目, 来路不明二次转载` | 默认剔除来源 |
| `naming_template` | `title_only` | 文件名默认使用“标题” |

可切换选项：

- `doc_type`:
  1. `undergrad_bishe_manual`（本科毕业设计说明书）
  2. `undergrad_bishe_report`（本科毕业设计报告）
  3. `course_design_manual`（课程设计说明书）
- `advisor_preference`:
  1. `engineering_first`（工程实现优先）
  2. `theory_first`（理论分析优先）
  3. `experiment_first`（实验评测优先）

## Hard Gates

以下规则是硬约束：

1. 用户第一次说“为项目生成毕业设计说明书”时，必须先索要辅助资料。
2. 输入资料分级：
   - 必需资料：项目源码路径、题目、字数要求、学校模板（若无需用户明确确认“无模板”）
   - 可选资料：往届样文、开题报告、任务书、封面字段要求、导师意见截图
3. 在用户明确表示“没有更多资料”或已经给出可分析资料之前，禁止直接生成正文初稿。
4. 如果用户给了样文或模板，必须先分析样文与样式，先回传“建议目录 + 目标字数 + 样式摘要 + 冲突项”，等待确认后才能开写。
5. 无样文应急流程仅在用户明确同意后启用：按学校模板 + 项目源码 + 默认章节模式写“可修订版初稿”，并显式标记风险。
6. 严禁虚构实验结果、虚构系统模块、虚构部署数据、虚构参考文献。
7. 必须执行敏感信息过滤：账号、口令、密钥、手机号、身份证号、真实服务器公网信息默认脱敏。
8. 输出文件名必须使用题目命名模板，不得使用 `final`、`draft`、`paper-final` 等通用名。
9. 除主说明书 `.docx` 外，必须额外交付一个“附件 `.docx`”，用于收录正文中的 Mermaid / PlantUML / E-R 图源码及关键流程源码。
10. 第 4 章“系统详细设计与实现”默认是全文最长章节，且每个一级模块默认都要包含：模块说明、页面截图、关键实现片段。
11. 第 4 章最长规则允许例外：
    - 学校模板明确要求“实验评测”章节更长
    - 项目是算法/实验型课题且用户确认以实验章为主
12. 若正文数据库设计部分缺少 E-R 图，则视为未完成。
13. 若用户提供任务书/开题报告/模板/样文，必须先分析这些材料，禁止绕过分析直接生成正文。
14. 冲突默认优先级：学校模板 > 任务书/开题报告 > 用户明确要求 > 样文 > 项目源码 > README > 旧说明文档。
15. 允许用户覆盖冲突优先级。覆盖格式：`冲突优先级覆盖: A > B > C`。
16. 旧部署说明、历史演示文档默认低可信；除非用户明确指定，否则不能作为事实主依据。

## Execution States

本技能默认按以下状态机执行：

1. `intake_only`
   只收资料，不写正文。
2. `sample_analysis_done`
   已完成样文/模板/任务书分析，但未开写。
3. `outline_confirmed`
   用户已确认目录、字数和样式方案。
4. `writing_allowed`
   允许开始正文写作。
5. `revision_round`
   根据导师或用户反馈执行定向回改。
6. `qa_gate`
   进入最终校验关卡，未通过不得交付。
7. `delivery_done`
   已生成主说明书、附件与校验产物。

状态约束：

- 未进入 `outline_confirmed` 前，禁止写正文。
- 若用户补交新模板、新样文或新任务书，状态必须退回 `sample_analysis_done`。
- 只有进入 `writing_allowed` 后，才允许生成主说明书 `.md` / `.docx`。
- `revision_round` 完成后必须再次进入 `qa_gate`。

## Core Flow

### 1. 锁定输入

先确认以下输入并确定优先级：

1. 学校模板
2. 任务书/开题报告
3. 往届样文
4. 用户口头要求
5. 项目源码
6. README
7. 旧项目说明文档
8. 技能默认规则

首次响应毕业设计请求时，必须主动告诉用户可提供本地路径，示例：

- `D:\毕业设计模板.docx`
- `D:\毕设样文1.docx`
- `D:\开题报告.pdf`

并明确说明：

- 未提供样文、模板或任务书前，当前阶段只收集资料与分析，不直接开写。
- 用户确认“没有更多资料”后，才可按源码和默认规则继续。

### 2. 冻结项目事实

先读项目代码和文档，再提炼“固定事实底稿”。后续各章只能基于该底稿扩写。

冻结事实时必须区分：

1. 任务书要求
2. 源码实际实现
3. 说明书最终采用口径

若三者不一致，必须在目录确认阶段提前提示，不得写完后再返工。

每章写作前后都要维护“事实来源表”，至少包含：

- `chapter`
- `fact_id`
- `claim`
- `source_type`（template/taskbook/code/readme/user）
- `source_path_or_ref`
- `confidence`

### 3. 学样文，不只学目录

如果用户提供样文或模板，必须同时分析：

- 结构：目录、页数、字数、图表节奏
- 样式：标题、正文、摘要、关键词、图题表题、参考文献、致谢
- 细节：中英文正文的字体字号、段前段后、行距、首行缩进
- 标题：各级标题字体字号、加粗、对齐、分页方式
- 表图代码：图题、表题、表格内容、代码块/代码截图插入位置与样式

对应资源：

- `prompts/sample_analyzer.md`
- `prompts/style_extractor.md`
- `tools/analyze_sample_pdf.py`
- `tools/analyze_docx.py`

### 3.5 先回传设计，再开写

模板和样文分析结束后，必须先回传并等待确认：

1. 当前建议目录
2. 各章目标字数
3. 正文/标题/摘要/关键词/图题/表题样式
4. 与默认规则冲突项

回传时默认输出 4 张表：

1. 输入资料表
2. 建议目录表
3. 字数预算表
4. 样式与冲突表

若用户补充了新样文、模板或任务书，必须中断写作并回到本步骤重分析。

### 4. 先定字数，再写作

写正文前必须生成目标章节字数表。默认贴近样文体量，不默认写厚。

- 写完一章就统计一次，超出即压缩。
- 章节策略默认遵循 `advisor_preference`。
- 第 4 章默认最长；若触发例外规则，需先记录“例外原因 + 用户确认”。

对应资源：

- `prompts/chapter_writer.md`
- `tools/count_chapter_words.py`
- `references/chapter-patterns.md`

### 4.5 章节完成定义（DoD）

每章在进入下一章前，至少满足：

1. 本章事实来源表已更新
2. 有明确小结，且与本章内容一致
3. 关键术语与命名前后一致
4. 图表、截图、代码片段编号连续
5. 未出现“实现了较好效果”等无依据空话

### 5. 图表与截图闭环

图表默认分两档：

- 最小可交付集（必须）：
  1. 系统架构图
  2. 功能模块图
  3. 关键业务流程图
  4. E-R 图（总表 + 核心表）
  5. 测试用例表
- 增强集（按时间和资料补充）：
  1. 权限流程图
  2. 时序图
  3. 部署拓扑图
  4. 关键接口时延/吞吐图

截图默认要求：

- 第 4 章每个主要模块至少 1 张页面截图
- 跨角色模块优先补“管理端 + 用户端”双端截图
- 截图标题必须对应模块名，禁止“系统页面图”这类泛标题

截图失败回退：

1. 无法登录系统时，先保留截图占位并标记原因
2. 以线框图/流程图临时替代，并在附件写明“待替换截图清单”
3. 交付前明确区分“真实截图”和“占位图”

代码片段默认要求：

- 第 4 章每个主要模块至少 1 段关键实现（代码或 SQL）
- 代码用于解释业务规则，不堆大段源码
- 大段源码放附件，不直接塞正文

若存在 `mermaid` / `plantuml`，优先渲染真实图片；失败再退回源码或占位。

对应资源：

- `tools/render_mermaid.py`
- `tools/ensure_thesis_assets.py`
- `tools/extract_screenshot_placeholders.py`
- `tools/build_screenshot_plan.py`
- `tools/capture_thesis_screenshots.py`

### 6. 参考文献先建池再回填

文献工作流必须分 5 步执行：

1. 建候选池
2. 做真实性核验
3. 做相关性筛选
4. 格式化参考文献
5. 生成文献核验清单

默认约束采用参数化，而非写死：

- 年份下限：`min_year`（默认 `2020`）
- 中文数量：`cn_count_range`（默认 `10-12`）
- 英文数量：`en_count_range`（默认 `3-5`）

来源策略：

- 优先 `reference_whitelist`
- 直接剔除 `reference_blacklist`
- 不确定真实性的条目不写入正文

必须增加“引用-正文映射检查”：

- 每条参考文献至少在正文出现 1 次引用落点
- 每个正文引用标记必须能映射到参考文献列表条目
- 发现孤儿引用或孤儿条目必须修复后再交付

文献交付产物默认至少包括：

- 正文参考文献列表
- `references-verified.json` 文献核验清单

文献核验字段：

- `title`
- `authors`
- `year`
- `source`
- `doi_or_url`
- `citation_count_if_available`
- `relevance_note`
- `status`

对应资源：

- `prompts/reference_selector.md`
- `tools/build_reference_pool.py`

### 7. DOCX 成稿交付

如果环境具备 `doc` / `docx` 能力，必须生成 `.docx` 成稿，不得只停留在 Markdown。

交付物至少包括：

1. 主说明书 `.md`
2. 主说明书 `.docx`
3. 图像映射文件
4. 附件 `.docx`
5. `references-verified.json`
6. 答辩版精简稿 `.docx`

命名模板（至少支持二选一）：

1. `title_only`：`题目.docx`
2. `student_name_title`：`学号-姓名-题目-毕业设计说明书.docx`

派生文件命名示例：

- `题目.md`
- `题目.docx`
- `题目-附件.docx`
- `题目-image-map.json`
- `题目-文献核验清单.json`
- `题目-答辩版.docx`

附件 `.docx` 默认内容：

- 正文中的 Mermaid / PlantUML 源码
- 数据库 E-R 图源码
- 关键流程图源码
- 必要时补充核心 SQL / 接口结构说明

答辩版精简稿要求：

- 删除超长源码段，仅保留关键片段
- 合并重复图表
- 每章结尾补“答辩要点”小节

默认样式规则：

- 摘要、Abstract、参考文献、致谢标题居中
- 摘要与 Abstract 独立分页
- 一级章节分页开始
- 中文正文宋体，英文正文 Times New Roman
- 中文关键词单独成段，顶格；“关键词：”黑体小四加粗，内容宋体小四
- 英文关键词单独成段，顶格，不首行缩进，Times New Roman 小四
- 参考文献悬挂缩进

对应资源：

- `prompts/docx_formatter.md`
- `tools/generate_thesis_docx.py`
- `tools/analyze_docx.py`
- `references/default-style.md`

### 8. 最终检查（QA Gate）

交付前必须检查：

- 章节完整
- 字数接近样文目标
- 参考文献比例正确
- 引用-正文映射通过
- 图表编号连续
- 是否残留占位符
- `.docx` 是否真实存在
- 主说明书文件名是否符合命名模板
- 附件 `.docx` 是否真实存在
- 第 4 章是否满足“最长或例外已确认”
- 第 4 章每个主要模块是否包含截图
- 第 4 章每个主要模块是否包含关键实现片段
- 第 3 章设计图数量是否达标
- E-R 图是否按要求包含总表图和核心表图
- 文献年份是否满足 `min_year`
- 是否混入低可信旧文档事实

新增 AI 套话检测（命中后需改写）：

- “具有重要意义”
- “实现了良好效果”
- “具有较高实用价值”
- “在一定程度上”
- “为后续研究奠定基础”

命中规则：

- 单章重复命中 >= 3 次，必须改写该章。

只有通过该关卡，状态才允许从 `qa_gate` 进入 `delivery_done`。

### 9. 回改与答辩支持

导师或用户反馈后必须进入 `revision_round`，并输出“修改影响清单”：

1. 改动章节
2. 改动原因
3. 事实来源变化
4. 是否影响图表/引用/字数

必须生成“答辩问答清单（默认 20 题）”，覆盖：

- 选题背景
- 技术选型
- 核心模块
- 数据库设计
- 安全与权限
- 测试与性能
- 局限性与改进

每题至少包含：

- 标准回答（30-90 秒）
- 追问点
- 回答禁区（不能说的模糊话）

版本快照命名规则：

- `v0-intake`
- `v1-outline-confirmed`
- `v2-writing`
- `v3-revision-YYYYMMDD`
- `v4-qa-pass`
- `v5-delivery`

每次进入新状态都要保留快照，防止回改覆盖。

## Style Guardrails

正文语言默认遵循以下约束：

1. 模仿样文的章节推进节奏，不机械复刻原句。
2. 优先写项目事实，不先写空泛结论。
3. 避免密集排比句、模板化总分总和明显 AI 套话。
4. 每章至少一部分直接对应源码中的真实模块、真实规则或真实数据结构。
5. 致谢可自然，但正文章节不口语化。
6. 全文默认称呼统一为“毕业设计/毕业设计说明书”，不再使用“论文”作为主称呼。

最终检查细则见：

- `prompts/final_checker.md`

## Resource Map

- 项目输入与冲突决策：`prompts/intake.md`
- 样文结构分析：`prompts/sample_analyzer.md`
- 样式提取：`prompts/style_extractor.md`
- 项目事实提取：`prompts/fact_extractor.md`
- 章节写作与控字：`prompts/chapter_writer.md`
- 参考文献筛选：`prompts/reference_selector.md`
- Word 格式化：`prompts/docx_formatter.md`
- 最终检查：`prompts/final_checker.md`

- 默认版式：`references/default-style.md`
- 章节模式：`references/chapter-patterns.md`

- 统计章节字数：`tools/count_chapter_words.py`
- 分析样文 PDF：`tools/analyze_sample_pdf.py`
- 分析样文 DOCX：`tools/analyze_docx.py`
- 检查参考文献池：`tools/build_reference_pool.py`
- 生成文献核验清单模板：`tools/write_reference_verification_template.py`
- 图表与截图补全检查：`tools/ensure_thesis_assets.py`
- 提取截图占位符：`tools/extract_screenshot_placeholders.py`
- 生成图源码附件 DOCX：`tools/generate_diagram_appendix_docx.py`
- 生成截图计划：`tools/build_screenshot_plan.py`
- 自动抓取页面截图：`tools/capture_thesis_screenshots.py`
- 渲染 Mermaid：`tools/render_mermaid.py`
- 生成 DOCX：`tools/generate_thesis_docx.py`

## Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [however-yir](https://github.com/however-yir)
- **Source:** [however-yir/claude-skills](https://github.com/however-yir/claude-skills)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-however-yir-claude-skills-bishe-manual-skill
- Seller: https://agentstack.voostack.com/s/however-yir
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.