Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 

Repository files navigation

实验报告助手

AI 实验报告写作 Skill —— 一次编写,多平台可用

面向中国高校本科生,自动生成学术规范的实验报告。支持 5大学科 × 4级详细程度 × 6种用户场景,覆盖从"明天要交"到"求高分课程设计"的全部需求。


支持的平台

本 Skill 采用通用 Markdown 格式编写,兼容所有支持自定义指令/Skill 的 AI 工具:

平台 安装路径
OpenCode ~/.config/opencode/skills/experiment-report/SKILL.md
Claude Code ~/.claude/skills/experiment-report/SKILL.md
Cursor 将 SKILL.md 内容粘贴到 .cursor/rules/ 或 Cursor Rules
其他 AI 工具 将 SKILL.md + prompts/ + references/ 作为系统提示词或知识库注入

不同平台加载机制略有差异,核心提示词内容完全通用。


快速安装

# OpenCode / Claude Code(一条命令搞定)
git clone https://github.com/YOUR_USERNAME/experiment-report.git ~/.config/opencode/skills/experiment-report
# 或
git clone https://github.com/YOUR_USERNAME/experiment-report.git ~/.claude/skills/experiment-report

其他平台:将本仓库作为知识库或自定义指令导入即可。


效果示例

场景 用户输入 AI 行为
标准 "写一份盐酸滴定氢氧化钠的实验报告" 询问学科、等级,中等级完整生成
紧急 "明天要交,快帮我写归并排序的实验报告" 只问名称+学科,秒出框架
高分 "要高分,链表操作,C语言,课程设计" 自动升级高等级,追加创新点
数据 "帮我处理:1.02, 1.05, 0.98, 1.01" 识别多组测量,计算均值±标准差
模板 "按这个模板写:[上传文件]" 提取章节结构,确认后适配
求助 "完全不会做这个实验怎么办" 白话原理+保姆级步骤+错误预防

能力矩阵

五大学科

学科 特征
物理 不确定度计算、x = ˉx ± Δx、误差棒图
化学 方程式配平、产率计算、废液处理
生物 显著性标注、伦理声明、显微规范
计算机 完整可运行代码,注释密度分四级
工科 系统框图、安全规程、设备参数

四级详细程度

等级 字数 适用
无 500-800 只要框架
低 1000-1500 时间紧
中 2000-3500 标准报告
高 4000-7000 求高分

计算机代码注释

所有等级代码完整可运行,差异仅在注释密度:

等级 注释标准
无 每函数 ≤1 行
低 函数 + 关键逻辑块
中 docstring + 每 ~10 行 1 行
高 逐行 + 复杂度 + 优化思路

文件结构

├── SKILL.md                    # 主入口(状态机 + 三阶段流程)
├── prompts/
│   ├── intake.md               # 阶段一:场景识别 + 信息收集 + 等级确认
│   ├── content-generator.md    # 阶段二:结构/学科/数据/代码/高分
│   └── quality-checker.md      # 阶段三:自检 + 输出格式 + 快捷指令
└── references/
    ├── disciplines.md           # 五学科规范(含优先级标注)
    ├── detail-levels.md         # 等级定义 + 代码注释标准
    └── special-scenarios.md     # 六种场景处理策略

设计理念:SKILL.md 为流程骨架,prompts/ 为执行层(规则→动作),references/ 为知识层(表格化,AI 查表不推理)。


对话状态机

INTAKE ──→ GENERATING ──→ REVIEW
  ↑                          │
  └──────── 新信息 ──────────┘
  • INTAKE:收集信息
  • GENERATING:生成中,仅接受"取消"
  • REVIEW:可快捷指令和部分修改

快捷指令

报告输出后可用:

指令 作用
+数据 进入数据处理模式
+图 生成可视化代码
升级 / 降级 调整等级
XX部分详细点 单独扩写

贡献

欢迎 PR。新增学科或场景请遵循现有结构:

  • 新增学科 → references/disciplines.md
  • 新增场景 → references/special-scenarios.md

许可

MIT

About

> AI 实验报告写作 Skill —— 一次编写,多平台可用 面向中国高校本科生,自动生成学术规范的实验报告。支持 5大学科 × 4级详细程度 × 6种用户场景,覆盖从"明天要交"到"求高分课程设计"的全部需求。

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors