Stata-sep（基于 Stata-MCP）
核心思路
- 目标：在 Claude Code 等 MCP 客户端中，把 Stata-MCP 的全部工具（工具列表见下文）和 agent/评估用法包装成可复用流程，减少提示词负担。
- 输出优先级：先给高层决策与最小可运行路径，再按需展开到具体工具调用/样例（渐进披露）。
- 安全默认：仅使用绝对路径；写/改文件或运行 do 前明确路径；安装 ado 包需用户确认。
快速起步（最小可用链路）
- 环境探测：
uvx stata-mcp --usable；若stata_cli失败，设置环境变量stata_cli为 Stata 可执行绝对路径（macOS 如/Applications/Stata/StataMP.app/Contents/MacOS/stata-mp，Windows 如C:\\Program Files\\Stata18\\StataSE.exe）。可选documents_path。 - 将 MCP server 加入客户端（示例 config JSON 已放
references/usage.md）。默认工作根：~/Documents/stata-mcp-folder/，自动包含stata-mcp-log/、stata-mcp-dofile/、stata-mcp-result/、stata-mcp-tmp/。 - 最小流水线：
- write_dofile 写入完整 do，必要时先调用 results_doc_path 生成输出目录。 - stata_do 运行 do，返回日志路径与内容。 - read_file 查看日志或结果。 - 若需数据概览，先用 get_data_info（支持.dta/.csv）。
工具地图（全量覆盖）
help(cmd)（Unix only）：返回 Stata help。用于快速查语法。write_dofile(content, encoding?, strict_mode?)：把 Stata 代码写入新 do，返回绝对路径。建议在顶部use数据并设置local output_path（来自results_doc_path）。append_dofile(original_dofile_path, content, encoding?)：在现有 do 基础上追加，或新建副本；返回新 do 路径。stata_do(dofile_path, log_file_name?, is_read_log=True)：执行 do，返回log_file_path和可选log_content。read_file(file_path, encoding="utf-8")：读取任意文本文件内容。get_data_info(data_path, vars_list?, encoding="utf-8")：对.dta/.csv 生成描述性统计，结果写入 tmp 目录并返回概要。ado_package_install(package, source="ssc"|"github"|"net", is_replace=True, package_source_from=None)（Unix only）：安装 ado；首次使用需确认。load_figure(figure_path)：载入 png/jpg，便于回显图形。mk_dir(path)：安全创建目录。- Prompts：
stata_assistant_role(lang?)、stata_analysis_strategy(lang?)、results_doc_path()生成输出目录。
推荐工作流（逐层展开）
- 数据理解：
get_data_info→ 选择变量/样本 → 形成 do 草稿。 - do 生成：
- 快速试验用 write_dofile；增量修改用 append_dofile。 - 需要表格输出时先 results_doc_path，在 do 里 local output_path "<返回路径>"，配合 outreg2/esttab。
- 执行与回溯：
stata_do→ 如失败查看log_content或用read_file重读；必要时追加 do 并重跑。 - 包依赖：缺少命令时，用
ado_package_install(",")安装；完成后复跑。 - 产出：用
load_figure回显图形，用read_file回显表格/日志。
Agent 模式与评估
- Agent：
uvx stata-mcp --agent或直接stata-mcp --agent，修改示例任务位于stata-mcp/source/agent_examples/openai/main.py（model_instructions与task_message）。 - 作为工具：
StataAgent.as_tool()示例见source/docs/Usages/agent_as/agent_as_tool.md。 - 评估：流程与样例问答在
source/docs/Usages/Evaluation.md；可据此自定义评测集合。
参考资料（按需加载）
references/usage.md：客户端配置、环境变量、最小命令速查。绝对路径：/Users/lingguiwang/Skill-Seekers/Github/stata-sep/references/usage.md。references/tools.md：各工具参数与返回字段、常见坑。绝对路径：/Users/lingguiwang/Skill-Seekers/Github/stata-sep/references/tools.md。references/usage_full.md：官方 Usage 详版（中英混排）。references/advanced.md：高级用法（传输方式、定制路径等）。references/questions.md：常见问题汇总。references/evaluation.md：评估流程与示例问答生成方法。references/agent_as_tool.md：将 Stata-Agent 作为工具嵌入其他 agent 的示例。assets/config.json：最小配置模板，可直接拷贝调整绝对路径与环境变量。assets/agent_examples/：可直接复制的 agent 示例代码（OpenAI/prompt 生成）。
注意事项
- 所有路径使用绝对路径；Windows 需转义反斜杠。
- 运行/写入前确认目标目录，避免覆盖用户文件。
- 安装 ado、创建目录等潜在改动操作需先向用户确认。