- name
- tcm-clinic
- description
- A full-featured management tool for solo Traditional Chinese Medicine (TCM) practitioners. Manages patient records, medical charts (Four Diagnostic Methods, pattern differentiation, prescriptions), herbal inventory (stock-in, stocktake, low-stock alerts), appointment scheduling, and financial bookkeeping with statistics. Data stored in Excel format. Use when: user mentions patients, medical records, prescriptions, herbs, inventory, appointments, scheduling, billing, finances, clinic, consultation fees, or needs day-to-day clinic management. NOT for: academic TCM theory discussions, formula research, or herb pharmacology analysis.
- requires
- binary
- python
中医诊所管理系统 (TCM Clinic)
概述
本 Skill 为一人经营的中医诊所提供轻量级全流程管理能力，涵盖五大模块：
| 模块 | 触发词示例 |
|---|---|
| 🏥 患者档案 | 新患者、建档、查患者、找患者 |
| 📋 病历记录 | 写病历、四诊、辨证、处方、历史病历 |
| 🌿 中药库存 | 入库、进药、查库存、低库存预警、配药扣减 |
| 📅 预约排班 | 预约、挂号、今日预约、排班 |
| 💰 财务收费 | 收费、记账、统计、月报、报表 |
所有数据以结构化 Excel 文件存储在 clinic_data/ 目录下。
When to Run
- 用户要求登记新患者或查询患者信息
- 用户需要记录或查看病历、处方
- 用户提到中药入库、查库存、缺药预警
- 用户需要管理预约、查看今日排班
- 用户要求收费记账、生成收入报表
- 用户发起"接诊"请求（一站式看诊流程）
- 用户要求"初始化诊所"（首次使用）
Workflow
决策路由
根据用户意图路由到对应模块：
用户请求
├── 患者相关？ → 患者管理模块
│ ├── "新患者建档" → 创建患者记录
│ ├── "查患者" / "找患者" → 按姓名/手机号/ID 查询
│ ├── "改患者信息" → 更新患者档案
│ └── "患者列表" / "所有患者" → 输出患者汇总
├── 病历相关？ → 病历记录模块
│ ├── "写病历" / "记病历" → 新增病历（含四诊、辨证、处方）
│ ├── "查病历" / "历史病历" → 按患者查询历史就诊记录
│ └── "改病历" → 修改已有病历
├── 药材相关？ → 中药库存模块
│ ├── "入库" / "进药" / "采购" → 新增药材或增加库存
│ ├── "查库存" / "药材库存" → 查询库存状况
│ ├── "低库存" / "缺药" → 低库存预警报告
│ ├── "出库" / "配药扣减" → 减少库存
│ └── "库存盘点" → 生成库存盘点表
├── 预约相关？ → 预约排班模块
│ ├── "预约" / "挂号" / "排班" → 新增预约
│ ├── "今日预约" / "今天的病人" → 查看当日排班
│ └── "改预约" / "取消预约" → 修改预约状态
├── 财务相关？ → 财务记账模块
│ ├── "收费" / "记账" / "收诊金" → 新增财务记录
│ ├── "查账" / "收入" / "流水" → 查询财务记录
│ ├── "统计" / "报表" / "月报" → 生成收入统计报表
│ └── "患者费用" / "欠费" → 查询患者费用汇总
└── 综合请求？ → 多模块联动
├── "接诊" → 预约→病历→收费 一站式流程
├── "诊所报表" / "经营分析" → 综合经营数据报告
└── "今日汇总" → 当日各模块数据汇总初始化新诊所
首次使用或用户要求"初始化"时，执行：
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使用策略
- 简单查询和标准 CRUD：直接调用脚本命令，解析 JSON 输出结果
- 复杂业务逻辑（如一站式接诊、多模块联动）：结合对话式交互与脚本命令，先查询数据再处理
- 报表生成：脚本提供基础统计，进一步格式化为 Markdown 表格
数据操作原则
- 首次使用前检查：确认
clinic_data/目录存在，不存在则提示用户初始化 - 新增操作：自动生成 ID，校验必填字段，追加新行
- 修改操作：根据 ID 定位目标行，仅更新指定字段
- 删除操作：标记为"作废"或"取消"，不物理删除
- 关联更新：新增病历时自动更新患者的
last_visit_date和visit_count
一站式接诊流程
当用户发起"接诊"请求时，按以下顺序执行：
- 确认或选择患者（从已有患者中选择或新建档案）
- 查看该患者的历史病历摘要（最近一次诊断和处方）
- 记录本次就诊的四诊信息（望闻问切）、辨证论治和处方
- 计算费用（挂号费 + 药费等）并生成财务记录
- 若涉及中药处方，自动扣减对应药材库存并检查低库存
- 输出本次接诊的完整摘要
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格式 - 低库存预警使用 ⚠️ 标记
- 操作成功使用 ✅ 标记
- 错误信息使用 ❌ 标记
- 对话中使用中医专业术语（四诊合参、辨证论治、理法方药）
交互风格
- 对话简洁专业
- 录入数据时，若用户未提供必填字段，主动询问补充
- 执行写操作前，简要确认操作内容
- 报表统计按费用类型和支付方式分组，显示占比