python执行器（pyx）
pyx 是LLM/Agent工作流的本地跨平台执行器。 它是为 循证调试和可重复提示：通过MANIFEST_IO（文件+清单）运行工作，保留检查日志，并将事件工作转化为可重用的技能。
从这些提示性的第一个用例开始：
此仓库围绕三个可重复的输出进行设计：
- 技能：可重用的、基于文件的规则+引用（新会话的引导）
- MANIFEST_IO运行：脚本+输入JSON+清单+日志+输出
- 调查日志：可重复的代码验证和审计
从这里开始（公共回购工作流）
1） 生成pyx-Claude技能（交互式）
运行：
pyx gs行为：
- 问
publicvslocal隐私模式（默认：公开） - 生成
pyx技能并将其打印到终端 - 询问是否保存
- 如果保存，则询问是否覆盖现有输出
- 最后问在哪里保存：
- docs\pyx （默认） - %USERPROFILE%\.claude\skills\pyx - 自定义路径
2） 将MANIFEST_IO用于所有实际工作
宣言IO 是文件优先执行合同：
- 输入来自文件（JSON用于结构化输入）
- 输出是由清单索引的文件
- Stdout只是一个简短的总结（路径+大小）
- 在加载到LLM上下文之前，始终检查输出大小
参考： docs/manifest/references/manifest-io.md
核心工作流
培养技能
生成技能包（克劳德风格： SKILL.md + references/):
# Public-safe (recommended for committing)
pyx gs --skill all --privacy public -o skills
# Local (machine-specific; may include absolute paths/package inventory)
pyx gs --skill all --privacy local -o skills笔记：
--skill manifest生成独立的MANIFEST_IO规范。--skill learn生成技能提取工作流+摘要参考。--skill pyx专注于执行，并（温和地）依赖manifest+learn.--skill inspect侧重于调查日志+代码验证，并（温和地）依赖于manifest+learn.--skill summary生成领导摘要模板。--skill all生成：manifest+learn+pyx+inspect+summary.
会话引导（LLM应该先做什么）
LLM聊天记录不可靠。将回购视为真理的来源。
最小引导序列：
- 阅读
skills/pyx/上面列出的文件 - 跑
pyx info --json如果环境/工具很重要 - 通过以下方式执行任务
pyx run --file使用MANIFEST_IO
MANIFEST_IO（文件优先执行）
推荐模式：
pyx ensure-temp --dir "temp"
# Write: temp/.py
# Write: temp/.input.json
pyx run --file "temp/.py" --input-path "temp/.input.json"执行的脚本可以读取这些运行时变量（由自动设置 pyx run):
PYX_INPUT_PATH（可选）PYX_OUTPUT_DIR（总是）PYX_OUTPUT_PATH（总是；清单路径）PYX_LOG_PATH（总是）PYX_RUN_ID（总是）
代码验证+调查日志
对于“根据实际代码进行验证”任务，请使用 inspect 工作流：
- 创建专用日志：
temp/..inspect.md - 通过MANIFEST_IO脚本收集证据
- 在日志中记录清单/日志/输出文件路径
参考文献
学习技能（提取可重用的工作流）
使用“学习技能”一词来触发一个令牌高效的工作流程，该流程：
- 倒像
temp/.history.jsonl以及最近的清单/日志 - 仅摘要标题
- 建议
create/merge/overwrite - 生成技能预览
- 仅在用户明确确认后保存
参考： docs/learn/references/learn-skill.md
安装（本地开发）
git clone https://github.com/Anudorannador/python-executor.git
cd python-executor
uv tool install -e ".[full]"配置 .env:
- 窗户：
%APPDATA%\pyx\.env - Unix/macOS：
~/.config/pyx/.env
开始时间： .env.example.
验证：
pyx info配置（.env）
共同 PYX_* 配置变量：
PYX_UV_HTTP_PROXY,PYX_UV_HTTPS_PROXY,PYX_UV_NO_PROXY,PYX_UV_INDEX_URL（uv/pip代理/索引）
请参阅： .env.example
项目结构
docs/ 包含公共参考文档和示例输出。 skills/ 是LLM会话的推荐提交引导程序。
python-executor/
├── .env.example
├── docs/
│ ├── pyx.instructions.md
│ ├── pyx/
│ ├── inspect/
│ ├── manifest/
│ ├── learn/
│ └── summary/
├── skills/ # Recommended committed bootstrap
│ ├── manifest/
│ ├── learn/
│ ├── pyx/
│ ├── inspect/
│ └── summary/
└── src/
├── pyx_core/
└── pyx_cli/