科研 Skill
科研环境依赖诊断
setup-medsci
Diagnoses Python, R, Node, Git, Zotero and configured MCP servers with a pass/fail table. Use when a skill fails for a missing tool or the environment needs checking.
SKILL.md
Setup-MedSci Skill
Diagnose only. Never install, upgrade or configure anything — no brew install,
winget install, pip install, Rscript -e 'install.packages(...)', and no edits to
~/.claude.json or any MCP configuration (read claude mcp list only) — because auto-installers
for system Python and R are a support nightmare for non-developer users. If a tool is missing,
the user follows the setup doc themselves. Skill versions and content are out of scope
(validate_skills.sh, /manage-project status).
The diagnostic table is in English so it can be pasted into a GitHub issue. Remediation links
point to the docs/setup/ guides in the upstream medsci-skills repository (see the source: URL in
this skill's frontmatter), and only these five exist:
docs/setup/README.md, docs/setup/mac.md, docs/setup/windows.md, docs/setup/mcp-setup.md,
docs/setup/common-issues.md. These docs and the ~/medsci-skills/demo/ folder referenced below
are not shipped with this plugin — they live only in the upstream GitHub repository, so fetch them
from there (or tell the user to) before pointing someone at a link.
Prerequisites and Limitations
- The "Claude Code CLI" row (R5,
command -v claude) is specific to the Claude Code agent. When this skill is run from a different coding agent (Codex, Copilot, or another Codar-compatible host), skip that row or replace it with the equivalent CLI for the host agent, and do not report it as a blocking ❌ for a non-Claude host. docs/setup/*.mdand thecd ~/medsci-skills/demo/...command in Phase 4 point to the upstream GitHub repository, not to files included in this plugin; treat them as external links to share with the user rather than local files to open.
Workflow
Phase 1: Detect OS
uname -s
Darwin→ macOS →docs/setup/mac.mdLinux→ Linux (similar tooling to Mac) →docs/setup/mac.mdMINGW*,MSYS*,CYGWIN*, or detection failure on Windows →docs/setup/windows.md
Phase 2: Run Diagnostic Commands
Read references/setup-checklist.md and run every check in it — R1-R5 required, O1-O5 optional —
with its detect command, version command, minimum version and status rule. Use command -v <tool>
first to detect presence without running it (avoids triggering long initialization). Capture the
version output and the exit code, and report the version exactly as printed: if a command fails,
report the failure verbatim rather than a version that is "probably" installed. If command -v
finds the tool but the version command or its parse fails, mark the row ❌ and report the failing
command — the install is broken, not just outdated. An MCP server is ✅ only when
claude mcp list shows it connected; configured-but-disconnected is ⚠️.
Phase 3: Emit Checklist Table
Print a single Markdown table to stdout in this exact format, one row per check, with the doc link from the reference for the detected OS:
## MedSci Skills Setup Diagnostic
OS detected: <macOS | Linux | Windows>
Date: <YYYY-MM-DD>
| Component | Status | Detected | Required | Action |
|---|:---:|---|---|---|
| Python 3.11+ | ✅ / ❌ | 3.11.9 | 3.11+ | OK / See docs/setup/mac.md Step 2 |
| MCP: zotero | ✅ / ❌ / ⚠️ | Connected | optional | OK / See docs/setup/mcp-setup.md |
Summary: <X required components passed, Y missing>
Next step: <one-sentence action>
Status legend:
- ✅ Present and meets minimum version
- ❌ Missing or below minimum version
- ⚠️ Present but optional and not connected
Phase 4: Suggest Remediation
Use the reference's Summary Rules for the closing sentence.
- Everything required ✅ → point to Demo 1:
cd ~/medsci-skills/demo/01_wisconsin_bc && claude '/orchestrate --e2e'. - Any required row ❌ → print its doc link and tell them to follow that step. Do not offer to install; the doc tells them exactly what to copy-paste.
- Only optional MCP rows ❌ → explain that MedSci Skills work without MCP servers, but
lit-sync,verify-refsandwrite-paperare smoother with Zotero MCP; linkdocs/setup/mcp-setup.md.
Output
The diagnostic report goes to stdout. If the user asks for a copyable report (e.g. for a GitHub
issue), also write it to ~/.medsci-skills/diagnostic-YYYY-MM-DD.md and tell them where it is.
示例提示词
帮我检查一下本机的Python、R和Zotero环境配置是否正常。
所属插件
安装该插件会一并获得同领域的 58 个 Skill / MCP。
同插件的其他科研 Skill
- 医学AI论文检索优化Optimizes a medical AI paper’s title, abstract and metadata for AI search engines. Use when a paper should be findable and citable by RAG tools and AI search.
- 临床数据统计分析与建模Generates reproducible Python or R code for clinical statistics and tables. Use when collected data needs Table 1, regression, survival or agreement analysis.
- 作者发表记录与策略分析Analyzes a PubMed author record to classify study types and authorship patterns. Use when planning a publication strategy from a researcher’s track record.
- 批量队列暴露结局分析Generates one cohort-analysis script per exposure-outcome pair from one template. Use when a validated method must run across many variable combinations at once.
- 样本量估算与检验效能Walks a decision tree to the right test and computes sample size with IRB text. Use when planning how many patients a study needs before data collection.
- 因果推断方法设计Runs DAG-based, instrumental-variable, difference-in-differences or RD analyses. Use when an association in observational data must support a causal claim.
- 报告规范逐条核查Audits a manuscript item by item against 49 reporting and risk-of-bias checklists. Use when checking a draft against STROBE, CONSORT, TRIPOD or similar guidelines.
- 临床数据清洗与画像Profiles a clinical dataset and generates cleaning code in staged, approved steps. Use when a CSV or Excel dataset needs missing-value and outlier checks before analysis.
- 跨国队列数据协调对比Harmonizes variables and runs parallel weighted analyses across national surveys like KNHANES and NHANES. Use when comparing one exposure-outcome link across countries.
- 变量定义与截断值溯源Maps exposure, outcome and covariate definitions to a cited guideline and DB columns. Use when variable cutoffs need a citable basis before the study protocol.
- 本地化临床数据脱敏Runs a local, network-free script that detects and removes identifiers from clinical data. Use when data may contain PHI and must be de-identified before LLM analysis.
- AI对标专家基准研究设计Plans the arms, rubrics, calibration probes and reviewer panel for an AI-vs-expert benchmark. Use before data collection when designing an AI-vs-human rating study.
- 放射影像AI研究设计审查Reviews a study’s analysis unit, cohort logic, leakage risk and reporting-guideline fit. Use when checking a clinical or medical-AI study design before drafting.
- 传染病仓室模型拟合Builds and fits SIR, SEIR and SEIHR compartmental models with Rt estimation. Use when an outbreak or epidemic’s spread needs mathematical modeling in Python.
- ICMJE利益冲突声明填写Clones a pre-filled synthetic ICMJE COI form, replacing only date, name and title. Use when each author on a submission needs a disclosure form filled quickly.
- 机构Word表单内容填充Fills an institutional Word form, such as an IRB protocol, without breaking its layout. Use when drafted content must be rendered into a CJK-aware .docx template.
- 队列数据库选题挖掘Profiles a longitudinal cohort database and ranks research-topic proposals with gap evidence. Use when looking for a question an available cohort or registry can answer.
- 投稿期刊匹配推荐Matches a manuscript abstract against curated journal profiles and ranks candidates. Use when choosing where to submit, or re-targeting after a rejection.
- DOI全文批量获取Batch-downloads open-access PDFs for a list of DOIs via Unpaywall, PMC and OpenAlex. Use when full texts are needed for a screening set such as a meta-analysis.
- 数据集编码本自动生成Profiles every variable in a tabular dataset into a structured, citable codebook. Use when a CSV, Excel or Stata dataset needs a data dictionary before analysis.
- 全球卫生数据获取分析Accesses and analyzes global health data from WHO GHO, IHME GBD and Our World in Data. Use when DALYs, age-standardized rates or choropleth maps are needed.
- 医学AI项目基金申请书撰写Structures a grant proposal’s significance, innovation, approach, aims and milestones. Use when drafting a research funding proposal, including a Korean grant plan.
- 卫生经济学评价建模Builds Markov cohort models with QALYs, PSA and cost-effectiveness planes. Use when a health intervention needs a formal cost-effectiveness evaluation.
- AI写作痕迹识别改写Scans a manuscript for AI writing patterns and rewrites flagged passages carefully. Use when a draft or response letter reads as obviously AI-written.
常见问题
科研环境依赖诊断能做什么?
Diagnoses Python, R, Node, Git, Zotero and configured MCP servers with a pass/fail table. Use when a skill fails for a missing tool or the environment needs checking。
如何安装科研环境依赖诊断?
在科搭 Codar 左侧点击「插件」,在「组件」页签搜索「科研环境依赖诊断」并安装;在 Claude Code 或 Codex 中可以发送本页的安装提示词,或下载 Skill 包后解压到 ~/.claude/skills 或 ~/.codex/skills。
科研环境依赖诊断需要哪些权限?
该科研 Skill没有声明额外权限;执行具体操作时仍由 Agent 按自身规则请求确认。
科研环境依赖诊断经过官方审核吗?
是。SpeedSkills 收录的每个版本都会记录内容摘要与权限声明,当前版本已通过安全审核。