中医诊所管理系统

中医诊所管理工具，支持患者档案、病历记录、处方管理、中药库存、预约排班和财务统计，数据存Excel。

Security Scan

The skill's code and instructions mostly match a local Excel‑backed clinic manager, but there are a few inconsistencies (undeclared Python/runtime dependencies and a prompt‑injection signal in SKILL.md) and the skill requires file read/write capabilities — review before installing.

Purpose & Capability

Name/description, SKILL.md and the included Python script are coherent: a one‑person TCM clinic manager storing data as Excel files. However SKILL.md and README expect python3 plus Python packages (openpyxl, reportlab) but the skill's declared requirements list no required binary or runtime; that mismatch should be resolved (agent or user must provide Python). Allowed-tools (bash, read_file, write_to_file, search_content) are reasonable for a file‑based app but give the agent the ability to access files outside clinic_data if misused.

Instruction Scope

Runtime instructions limit operations to initializing and manipulating files under clinic_data/ and invoking the included script. They do not instruct network calls or credential access. However SKILL.md includes allowed-tools that permit arbitrary file reads/writes/searches; combined with the pre-scan finding of unicode control characters in SKILL.md (possible prompt‑injection pattern), this warrants caution — verify SKILL.md and the full script for any hidden instructions or unexpected behavior before granting file access.

Install Mechanism

No install spec: this is instruction+script only, so nothing is downloaded or executed automatically. README suggests installing Python packages via pip (openpyxl, reportlab). That manual dependency install is expected; there are no remote downloads or obscure installers in the provided manifest.

Credentials

The skill declares no environment variables or credentials, which is appropriate. It does require filesystem access to create/read/write clinic_data/*.xlsx — reasonable for the purpose. Still, the allowed agent tools (read_file, write_to_file, search_content) enable reading arbitrary files on the host; ensure the agent is only given the minimal workspace and not broad filesystem access if you have sensitive data on the host.

Persistence & Privilege

always is false and the skill does not request system‑wide configuration changes. The script writes local Excel files in the working directory; this is normal for a data management tool. There is no evidence in the provided files of it modifying other skills or agent configuration.

Scan Findings in Context

[unicode-control-chars] unexpected: Unicode control characters were detected inside SKILL.md. These can be used in prompt‑injection attacks (e.g., to obfuscate or break parsing). This is not expected for a normal README/instructions file and should be inspected and removed or explained by the author.

What to consider before installing

What to check before installing: 1) Inspect the full scripts/clinic_manager.py for any network calls, hidden endpoints, or code that reads system files beyond clinic_data. The repo preview was truncated — review the entire script. 2) Remove or examine any suspicious Unicode control characters in SKILL.md (they can hide instructions or alter parsers). 3) Ensure you have an isolated Python environment (python3) and install only the needed packages (openpyxl, reportlab) in a virtualenv. 4) Run the tool in a sandbox or test directory (not your home directory) so it only creates clinic_data/ there. 5) Because the agent is allowed read_file/write_to_file/search_content, limit the agent's filesystem permissions to the skill workspace to prevent accidental exposure of unrelated files. 6) If you expect PDF exports to be sent to external services (WeChat), confirm there is no automatic network send implemented; implement sending manually if needed. If you cannot inspect the full code or remove the unicode control characters, treat this as higher risk and avoid installing on sensitive systems.

中医诊所管理系统 (TCM Clinic)

概述

本 Skill 为一人经营的中医诊所提供轻量级全流程管理能力，涵盖五大模块：

模块	触发词示例
🏥 患者档案	新患者、建档、查患者、找患者
📋 病历记录	写病历、四诊、辨证、处方、历史病历、电子病历、导出PDF
🌿 中药库存	入库、进药、查库存、低库存预警、配药扣减
📅 预约排班	预约、挂号、今日预约、排班
💰 财务收费	收费、记账、统计、月报、报表
📊 汇总报表	生成报表、汇总表、打印报表、导出Excel、经营概况

所有数据以结构化 Excel 文件存储在 clinic_data/ 目录下。

When to Run

• 用户要求登记新患者或查询患者信息
• 用户需要记录或查看病历、处方
• 用户提到中药入库、查库存、缺药预警
• 用户需要管理预约、查看今日排班
• 用户要求收费记账、生成收入报表
• 用户发起"接诊"请求（一站式看诊流程）
• 用户要求"初始化诊所"（首次使用）
• 用户要求生成汇总报表、打印数据表、导出经营概况
• 用户要求生成电子病历 PDF、导出病历发给患者

Workflow

决策路由

根据用户意图路由到对应模块：

用户请求
├── 患者相关？ → 患者管理模块
│   ├── "新患者建档" → 创建患者记录
│   ├── "查患者" / "找患者" → 按姓名/手机号/ID 查询
│   ├── "改患者信息" → 更新患者档案
│   └── "患者列表" / "所有患者" → 输出患者汇总
├── 病历相关？ → 病历记录模块
│   ├── "写病历" / "记病历" → 新增病历（含四诊、辨证、处方）
│   ├── "查病历" / "历史病历" → 按患者查询历史就诊记录
│   ├── "改病历" → 修改已有病历
│   ├── "电子病历" / "导出PDF" / "发给患者" → 生成 PDF 电子病历
│   └── "病历汇总" → 生成患者全部病历 PDF
├── 药材相关？ → 中药库存模块
│   ├── "入库" / "进药" / "采购" → 新增药材或增加库存
│   ├── "查库存" / "药材库存" → 查询库存状况
│   ├── "低库存" / "缺药" → 低库存预警报告
│   ├── "出库" / "配药扣减" → 减少库存
│   └── "库存盘点" → 生成库存盘点表
├── 预约相关？ → 预约排班模块
│   ├── "预约" / "挂号" / "排班" → 新增预约
│   ├── "今日预约" / "今天的病人" → 查看当日排班
│   └── "改预约" / "取消预约" → 修改预约状态
├── 财务相关？ → 财务记账模块
│   ├── "收费" / "记账" / "收诊金" → 新增财务记录
│   ├── "查账" / "收入" / "流水" → 查询财务记录
│   ├── "统计" / "报表" / "月报" → 生成收入统计报表
│   └── "患者费用" / "欠费" → 查询患者费用汇总
├── 报表相关？ → 报表生成模块
│   ├── "生成报表" / "导出Excel" → 生成诊所汇总报表
│   ├── "打印报表" / "打印数据" → 生成适合打印的汇总表
│   └── "经营概况" / "诊所概况" → 生成经营分析报表
└── 综合请求？ → 多模块联动
    ├── "接诊" → 预约→病历→收费 一站式流程
    ├── "诊所报表" / "经营分析" → 综合经营数据报告
    └── "今日汇总" → 当日各模块数据汇总

初始化新诊所

首次使用或用户要求"初始化"时，执行：

python3 SKILL_DIR/scripts/clinic_manager.py init

这将在当前工作目录下创建 clinic_data/ 文件夹，包含 5 个空数据表（仅含表头行）。

脚本调用规范

使用 bash 工具执行以下命令格式：

python3 SKILL_DIR/scripts/clinic_manager.py <module> <action> [options...]

SKILL_DIR 需要替换为 Skill 的实际安装路径。 例如：~/.codebuddy/skills/tcm-clinic 或 ~/.openclaw/workspace/skills/tcm-clinic

常用命令

# 初始化
python3 SKILL_DIR/scripts/clinic_manager.py init

# 患者管理
python3 SKILL_DIR/scripts/clinic_manager.py patients add --name "张三" --gender "男" --phone "13800138000"
python3 SKILL_DIR/scripts/clinic_manager.py patients search --name "张"
python3 SKILL_DIR/scripts/clinic_manager.py patients list

# 病历管理
python3 SKILL_DIR/scripts/clinic_manager.py records add --patient-id "P20260402001" --complaint "头痛三日" --diagnosis "风寒头痛"
python3 SKILL_DIR/scripts/clinic_manager.py records search --patient-id "P20260402001"

# 中药库存
python3 SKILL_DIR/scripts/clinic_manager.py herbs add --name "黄芪" --quantity 500 --unit "g" --category "补气药" --purchase-price 0.15 --min-stock 100
python3 SKILL_DIR/scripts/clinic_manager.py herbs update --herb-id "H001" --quantity -50
python3 SKILL_DIR/scripts/clinic_manager.py herbs alerts
python3 SKILL_DIR/scripts/clinic_manager.py herbs list

# 预约排班
python3 SKILL_DIR/scripts/clinic_manager.py appointments add --patient-id "P20260402001" --time-slot "上午"
python3 SKILL_DIR/scripts/clinic_manager.py appointments today

# 财务统计
python3 SKILL_DIR/scripts/clinic_manager.py finance add --patient-id "P20260402001" --type "挂号费" --amount 50 --payment-method "微信"
python3 SKILL_DIR/scripts/clinic_manager.py finance summary --period day
python3 SKILL_DIR/scripts/clinic_manager.py finance summary --period month --month 2026-04

# 生成汇总报表（打印用）
python3 SKILL_DIR/scripts/clinic_manager.py report
python3 SKILL_DIR/scripts/clinic_manager.py report --limit 50  # 病历/预约显示50条

# 生成电子病历 PDF（用于微信发送）
python3 SKILL_DIR/scripts/clinic_manager.py records export-pdf --patient-id "P20260402001"
python3 SKILL_DIR/scripts/clinic_manager.py records export-pdf --patient-id "P20260402001" --record-id "R20260409001"

使用策略

• 简单查询和标准 CRUD：直接调用脚本命令，解析 JSON 输出结果
• 复杂业务逻辑（如一站式接诊、多模块联动）：结合对话式交互与脚本命令，先查询数据再处理
• 报表生成：脚本提供基础统计，进一步格式化为 Markdown 表格
• 打印报表：使用 report 命令生成格式美观的 Excel 汇总表，适合查阅和打印

数据操作原则

1. 首次使用前检查：确认 clinic_data/ 目录存在，不存在则提示用户初始化
2. 新增操作：自动生成 ID，校验必填字段，追加新行
3. 修改操作：根据 ID 定位目标行，仅更新指定字段
4. 删除操作：标记为"作废"或"取消"，不物理删除
5. 关联更新：新增病历时自动更新患者的 last_visit_date 和 visit_count

一站式接诊流程

当用户发起"接诊"请求时，按以下顺序执行：

1. 确认或选择患者（从已有患者中选择或新建档案）
2. 查看该患者的历史病历摘要（最近一次诊断和处方）
3. 记录本次就诊的四诊信息（望闻问切）、辨证论治和处方
4. 计算费用（挂号费 + 药费等）并生成财务记录
5. 若涉及中药处方，自动扣减对应药材库存并检查低库存
6. 输出本次接诊的完整摘要

ID 生成规则

• 患者ID: P + YYYYMMDD + 3位序号（如 P20260402001）
• 病历ID: R + YYYYMMDD + 3位序号
• 预约ID: A + YYYYMMDD + 3位序号
• 财务ID: F + YYYYMMDD + 3位序号
• 药材ID: H + 3位序号（如 H001，不按日期）
• 序号从现有数据中自动递增

数据字段参考

执行数据操作前，读取 references/data-schema.md 获取完整的字段定义（字段名、类型、是否必填、取值范围）。

主要数据表：

• clinic_data/patients.xlsx — 患者信息（姓名、性别、年龄、联系方式、体质类型、过敏史等）
• clinic_data/medical_records.xlsx — 病历记录（四诊信息、辨证、处方、医嘱）
• clinic_data/herbs_inventory.xlsx — 中药库存（药材名、规格、库存量、价格、保质期、最低库存）
• clinic_data/appointments.xlsx — 预约排班（日期、时段、患者、状态）
• clinic_data/finances.xlsx — 财务记录（就诊ID、费用类型、金额、支付方式）

Output Format

• 查询结果使用 Markdown 表格展示，关键数据 加粗
• 涉及金额时精确到分（如 ¥120.50）
• 涉及日期时统一使用 YYYY-MM-DD 格式
• 低库存预警使用 ⚠️ 标记
• 操作成功使用 ✅ 标记
• 错误信息使用 ❌ 标记
• 对话中使用中医专业术语（四诊合参、辨证论治、理法方药）

交互风格

• 对话简洁专业
• 录入数据时，若用户未提供必填字段，主动询问补充
• 执行写操作前，简要确认操作内容
• 报表统计按费用类型和支付方式分组，显示占比

汇总报表格式

生成的 诊所汇总报表_YYYY-MM-DD.xlsx 包含以下工作表：

工作表	内容	格式特点
患者总览	全部患者档案	隐藏内部ID字段，冻结首行
近期病历	最近 N 条病历（默认30）	按日期倒序，显示关键诊疗信息
中药库存	当前库存全表	低库存行红色背景高亮
预约记录	最近 N 条预约	按日期倒序
收入统计	按月汇总的收入数据	费用类型分列，含合计行
经营概况	综合仪表盘数据	本月就诊数、收入、库存预警等

打印适配：

• A4 横向纸张，页边距 0.5 英寸
• 自动缩放为页面宽度
• 标题行和表头行冻结
• 斑马纹行底色增强可读性

电子病历 PDF 导出

为指定患者生成专业的 PDF 电子病历文档，适合通过微信发送给患者查看。

命令格式

# 导出患者全部病历汇总
python3 SKILL_DIR/scripts/clinic_manager.py records export-pdf --patient-id "<患者ID>"

# 导出单次就诊病历
python3 SKILL_DIR/scripts/clinic_manager.py records export-pdf --patient-id "<患者ID>" --record-id "<病历ID>"

触发场景

当用户说"导出病历"、"生成电子病历"、"发病历给患者"、"生成PDF"等时触发此功能。

PDF 内容结构

区块	包含内容
页眉	"电子病历"标题 + 生成日期
患者信息	姓名、性别、年龄、电话、体质分型、过敏史、慢性病史
就诊记录	就诊日期、主诉、四诊合参（望闻问切）、舌诊、脉诊
诊断	中医病名 / 证型
处方	药物组成及剂量（表格形式）
医嘱	忌口、起居、复诊建议
页脚	页码

输出文件

• 路径：clinic_data/<患者姓名>_<就诊日期>_电子病历.pdf（单次）或 clinic_data/<患者姓名>_病历汇总_<日期>.pdf（全部）
• 格式：A4 纵向，中文排版
• 大小：通常 < 100KB，适合微信传输

依赖

需要安装 reportlab 库：pip3 install reportlab