Stata Help Skill — AI skill for Claude Code

stata-help Skill

`stata-help` 是一个面向 Stata 用户和 AI Agent 的文档查询 Skill。

它通过 Stata MCP 调用本机 Stata 帮助系统，自动查找 `.sthlp`、`.hlp`、`.ihlp` 帮助文件，并使用 Stata 自带的 `translate, translator(smcl2txt)` 将 SMCL 文档转换为纯文本，帮助 Agent 基于本机官方文档理解 Stata 命令的语法、选项、示例和 stored results。

为什么需要它

AI Agent 在生成 Stata 代码时，容易对用户自编命令或 SSC 命令产生语法幻觉，例如 option 名称写错、参数格式不准确、示例代码与本机版本不一致。

Stata 的 help 文件通常和本机安装的命令版本一致，因此让 Agent 先读取本机 help，再回答问题，可以显著提高 Stata 代码生成和解释的可靠性。

适用场景

• 查询 Stata 命令的官方帮助文档
• 查看 SSC 或用户自编命令的语法和选项
• 根据 help 文件生成更可靠的示例代码
• 理解 Stata 命令的 stored results
• 辅助解释论文复现代码或 .do 文件

工作原理

核心 Stata 流程如下：

findfile command.sthlp
translate command.sthlp output.txt, translator(smcl2txt) replace
type output.txt

Skill 会指导 Agent：

1. 从用户问题中提取 Stata help topic；
2. 使用 Stata MCP 执行 findfile 查找帮助文件；
3. 尝试 .sthlp、.hlp、.ihlp 等扩展名；
4. 使用 translate, translator(smcl2txt) 转换为纯文本；
5. 根据输出总结 Syntax、Options、Examples、Stored results 等内容。

文件说明

• skill.md：Skill 主文件，包含调用条件、Stata MCP 查询流程、错误处理和示例。

使用要求

• 本机已安装 Stata；
• 当前 Agent 环境可调用 Stata MCP；
• 要查询的 Stata 命令或包已安装在本机 Stata 环境中。

安装方法

方法一：直接克隆到 Claude commands 目录

如果你的 Agent 会从 `~/.claude/commands/` 读取 Skill，可以直接运行：

git clone https://github.com/ashuiGordon/stata-help-skill.git ~/.claude/commands/stata-help

安装后目录结构应类似：

~/.claude/commands/stata-help/
├── README.md
├── skill.md
└── LICENSE

重启或刷新 Agent 后，当你询问 Stata 命令文档、语法、选项或示例时，Agent 就可以根据 `skill.md` 调用 Stata MCP 查询本机 help 文件。

方法二：手动下载 skill.md

如果你不想克隆整个仓库，也可以手动创建目录并下载 `skill.md`：

mkdir -p ~/.claude/commands/stata-help
curl -L https://raw.githubusercontent.com/ashuiGordon/stata-help-skill/main/skill.md \
  -o ~/.claude/commands/stata-help/skill.md

方法三：放入其他 Skill 搜索目录

如果你的 IDE 或 Agent 使用其他 Skill 目录，请将本仓库中的 `skill.md` 放入对应目录，例如：

<你的-skill-目录>/stata-help/skill.md

关键是保持 `stata-help` 目录下存在 `skill.md`，并确保 Agent 能扫描到该目录。

验证安装

安装完成后，可以向 Agent 提问：

帮我查一下 oneclick 的 Stata 帮助文档

如果本机已安装 `oneclick`