Ptrade 策略编写 Skill

面向中文量化用户的 Ptrade 策略编写 skill，用于辅助 AI 编程工具编写、审查、迁移、调试和解释 Ptrade 量化交易策略。

Skills

• skills/ptrade-strategy-writing：用于编写、审查、迁移、调试和解释 Ptrade 量化交易策略。

每个 skill 都是一个自包含目录，至少包含 SKILL.md，并按需要携带 references/、scripts/ 等资源。这样安装或复制某个 skill 时，不会把仓库级说明、本地素材、会话配置或其他无关文件一起带进去。

适合谁

• 正在使用 Ptrade 做股票、ETF、可转债、融资融券或期货策略开发的人。
• 想把普通 Python、其他平台策略或自然语言交易规则迁移成 Ptrade 策略的人。
• 需要 AI 帮忙检查 Ptrade API 使用位置、事件函数、实盘重复下单风险和重启安全的人。

能做什么

skills/ptrade-strategy-writing 覆盖 Ptrade 回测和交易场景中的常见工作：

• 事件函数、行情数据 API 和下单 API
• ETF/LOF/可转债、融资融券和期货策略
• 持久化、实盘重启安全和重复下单保护
• API 可用范围、事件放置规则和目标环境检查
• 将普通 Python 或其他平台策略迁移为 Ptrade 兼容策略代码

目录内容：

• SKILL.md：skill 触发信息、工作流程、硬性要求、策略骨架、Ptrade 专用规则和审查流程。
• references/：Ptrade 运行规则、API 导航、API 索引、完整 Ptrade API 文档和示例策略。
• scripts/check_ptrade_strategy.py：静态检查脚本，用于发现常见的策略结构问题、API 放置位置错误、目标环境不匹配和实盘交易风险。

快速安装

最简单的方式：把整个 skills/ptrade-strategy-writing 目录复制到你使用的 AI 编程工具的 skills 目录里。

常见位置：

Claude Code 用户级: ~/.claude/skills/ptrade-strategy-writing
Claude Code 项目级: .claude/skills/ptrade-strategy-writing
Codex: ~/.codex/skills/ptrade-strategy-writing
其他工具: 放到该工具支持的 skills 目录

安装后，确认目录里直接包含 SKILL.md：

ptrade-strategy-writing/
  SKILL.md
  references/
  scripts/

然后在支持 skills 的工具中直接请求它使用 ptrade-strategy-writing 编写、审查、迁移或调试 Ptrade 策略即可。

示例请求：

使用 ptrade-strategy-writing，帮我把这个双均线策略改写成 Ptrade 日线回测策略，并检查是否有未来函数。

校验

在 skill 目录下运行内置检查脚本：

cd skills/ptrade-strategy-writing
python3 scripts/check_ptrade_strategy.py references/examples/*.py

该检查脚本偏保守。对 warning 应结合目标运行环境人工判断，尤其是实盘交易中的重复下单保护、重启行为、券商和柜台支持情况。

发布说明

skills/ptrade-strategy-writing/references/ 中包含的 Ptrade 文档和示例策略材料，是在仓库发布者已确认可以公开的前提下随仓库发布的。

本地源材料不会随仓库发布，例如导出的 .dat 文件、本地策略文件夹、本地会话设置、旧的 skill-src/，以及根目录原始 ptrade.md。这些内容已通过 .gitignore 排除。

免责声明

本仓库及其附带资料仅用于策略开发辅助，不构成投资建议、交易建议，也不构成对任何证券、基金、期货合约或其他金融工具的买卖推荐。

任何生成或审查后的策略，在投入真实资金前，都需要自行完成代码审查、回测、必要时的模拟交易、实盘风控、券商和柜台兼容性检查，以及风险控制验证。

许可证

MIT License，见 LICENSE。