piflow-skill-generator-planner

name	piflow-skill-generator_planner
description	PiFlow 技能生成器。当用户完成了一次完整并成功的数据处理任务时调用，根据当前 skills/generated 的本地约定和 references/piflow_skill_template.md 通用模板创建、更新或校验 PiFlow-compatible skill，包括 UTF-8 编码的 SKILL.md、DAG 可读的 input_params/output_params、version/tag 元数据、skill.json、scripts/references/assets 资源目录，以及本地校验脚本。仅在用户明确要求生成或保存 skill，或某次数据处理任务已经完成并需要把已验证成功的操作流程沉淀为 skill 时使用；默认不要因为“可能需要 skill”或“当前能力不足”而优先触发此 skill。
name_zh	PiFlow 算子生成器_planner
version	1.1.2
allowed-tools	["process"]
input_params	[{"name":"spec_path","type":"string","required":false,"description":"技能规格 JSON 文件路径，必须使用 UTF-8 编码；与 flow_path 二选一"},{"name":"output_root","type":"string","required":false,"default":"skills/generated","description":"输出根目录；deepagent 虚拟文件环境默认写入 skills/generated（相对于 workspace 根）"},{"name":"overwrite","type":"bool","required":false,"default":false,"description":"是否覆盖已存在的技能目录"},{"name":"thread_id","type":"string","required":false,"description":"当前会话 ID；提供后记录生成 skill 供前端预览"},{"name":"flow_path","type":"string","required":false,"description":"已验证成功的流程摘要 JSON 路径；与 spec_path 二选一"},{"name":"restored_spec_out","type":"string","required":false,"description":"使用 flow_path 时恢复出的 spec 草稿输出路径"},{"name":"rewrite_followup_hint","type":"string","required":false,"default":"","description":"可选提示语；当 skill 生成完成后，如用户随后给出新的流程，可提示是否进入生成器内部改写链路继续改写"}]
output_params	[{"name":"skill_dir","type":"directory","description":"生成后的技能目录"},{"name":"skill_md","type":"markdown_file","description":"生成后的 SKILL.md"},{"name":"rewrite_followup_suggestion","type":"json_file","description":"生成完成后的改写 follow-up 建议信息"}]
tag	算子生成

PiFlow Skill Generator Planner

核心规则

本技能是一个模板驱动的 PiFlow skill 生成器。它的职责不是找一个相似 skill 来改改，而是基于统一模板，把用户明确提供的信息、已经验证成功的流程、已有脚本和必要资源，整理成一个结构清晰、参数契约稳定、可被 PiFlow 直接识别的技能目录。

生成目标始终是一次性产出完整、可靠、符合约定的 skill 目录，包括 UTF-8 编码的 SKILL.md、DAG 可读的 input_params / output_params、skill.json、scripts/、references/、assets/，以及必要的校验与注册结果。每个生成的 skill 必须包含一个可执行 Python 入口脚本：优先复用已验证实现；没有现成实现时也必须生成 scripts/run_<skill_name>.py，使其可解析参数并输出结构化运行结果，禁止只生成元数据文件。但它不是默认优先入口；只有在用户明确要“生成/保存为 skill”，或某个流程已经真实跑通并值得沉淀时，才进入这条链路。

所有文本文件必须使用 UTF-8 读写，尤其是中文内容；Python 读写文件时显式使用 encoding="utf-8"，JSON 输出使用 ensure_ascii=False。

目录内容按职责分层：

• SKILL.md：只放触发条件、处理流程、参数契约和必要说明；
• scripts/：放稳定、可执行、可测试的入口脚本或处理逻辑；
• references/：放长规则、字段字典、复杂 schema、补充说明；
• assets/：放图标、模板、示例素材或需要随技能一起交付的资源。

本技能的实现指引遵循同一条主线：模板优先，参考次之，禁止默认整体仿写。

• 先以 references/piflow_skill_template.md 作为 SKILL.md、skill.json、参数组织方式、脚本入口形状和资源分层的统一骨架；
• 再把用户确认的信息、成功流程、已有脚本、现有 skill 中真正有用的规则和参数事实，填回模板对应位置； -当 spec 中提供 core_features、trigger_conditions、processing_logic、supported_formats、output_structure、output_examples 等字段时，将它们填入模板对应章节

因此，无论是直接生成、基于已验证流程生成，还是生成后的再次改写，最终输出都必须回到模板定义的结构，而不是回到某个历史 skill 的结构。

本技能必须能在没有其他技能辅助的环境中独立生成可靠技能：只依赖当前技能目录内的 SKILL.md、references/piflow_skill_template.md、scripts/generate_piflow_skill.py、scripts/generate_skill_files.py、scripts/register_skill_artifacts.py、scripts/rewrite_piflow_skill.py 和 scripts/validate_piflow_skill.py。生成时不要假设另一个 skill 会补全文档、脚本或元数据。本技能负责 skill 化与沉淀，不负责代替用户完成所有真实处理任务本身。

本技能支持两种使用方式：

1. 直接生成 当用户明确要求“生成 skill”“保存为 skill”“封装为 skill”“创建自定义技能”时，根据已确认的规格生成 skill。

2. 基于已验证流程生成或改写 当用户提供已验证成功的流程、脚本或输入输出约定时，优先复用这些事实生成或最小改写 skill；改写时默认保留原 skill 名称和目录位置，避免生成含义重复的新 skill。

在涉及安装、环境准备或可执行脚本验证时，优先完成最小必要依赖，再运行一个简单冒烟测试确认关键入口可执行、基础参数可解析、输出路径可写。若安装或测试失败，允许自动重试，单个阶段最多重试 5 次；若 5 次后仍失败，停止流程并把失败原因、失败步骤和最后一次错误返回给用户。