agent-skill-creator 是一个把现有工作转化为可复用智能体技能（agent skill）的工具。它的核心目标是让用户不需要写规格、不需要理解技能格式、不需要选择架构、也不需要审查实现细节，就能从已有的工作证据生成完整、可投入生产、跨平台的技能。
【用途】 用户的重复性工作中包含大量隐性知识，人们识别这些知识往往比事先记录下来更容易。该工具从用户提供的材料中推断这些知识，用通俗语言确认结果，自主构建，并给出用户可判断和纠正的具体输出。
【触发方式】 用户以 /agent-skill-creator 命令后跟输入来调用，例如： /agent-skill-creator Every week I pull sales data, clean it, and generate a report /agent-skill-creator https://wiki.internal/deploy-runbook /agent-skill-creator See src/invoice_processor.py — turn it into a reusable skill 也支持直接拖入文件、粘贴 URL、分享截图或提供极少上下文。用户还可以在不带前缀的情况下自然激活，例如 "Create a skill for analyzing CSV files"、"Automate this workflow"、"Validate this skill"、"Is this skill safe to install?" 等。
【主要能力与工作流程】 工具分为两个阶段。
第一阶段：理解与规格化（阶段 1-2）。先阅读用户提供的全部材料（文件、链接、PDF、代码），然后依次进行输入分类（文件、URL、截图、邮件链、单词短语、混合输入、粘贴的参考资料、完整描述）、构建前发现（检查数据是否已存在于数据库、同事是否已构建、是否有 API 可免去爬取）、以假设而非问卷的方式呈现理解、渐进式细化、失败向前推进。随后生成内部实现契约规格，包含问题定义、真实输入输出与数据源、用例、方法论、所需 API 或库、失败模式与边界情况。
第二阶段：构建与验证（阶段 3-5）。按规格端到端实现技能：组织目录、编写每个文件、生成可用代码（无占位符、无 TODO、无桩）。然后运行自动验证与安全扫描，失败则修复并重跑，不交付未通过自身质量门的技能。 五个阶段为：Phase 1 DISCOVERY（阅读全部材料、研究 API 与数据源）、Phase 2 DESIGN（生成内部规格）、Phase 3 ARCHITECTURE（组织技能目录结构）、Phase 4 DETECTION（编写激活描述与关键词）、Phase 5 IMPLEMENTATION（创建全部文件、验证、安全扫描、交付）。
【结构化访谈门控】 在 Phase 2 之前必须运行 python3 scripts/structured_interview.py gate interview.json。BLOCKED 表示继续发现或提出一个有限决策问题，绝不用臆造的确定性填字段；READY 才允许设计与生成。
【专项模式】 --mcp-audit：当用户指向供应商的 MCP 服务器并询问可在其上构建什么时，交付的是可行性图而非代码。枚举服务器真实工具清单、映射数据面、把候选技能分为可构建（每一步映射到具名工具）与不可构建（指名缺失的原语）。输出 MCP_AUDIT.md 和 mcp_audit.json，由 python3 scripts/mcp_audit_validate.py mcp_audit.json 门控。 --audit：当用户指向非自己创建的技能（下载、同事文件夹、注册表条目）时，交付的是关于是否安全安装的裁决，而非构建。运行 python3 scripts/validate.py <path> 和 python3 scripts/security_scan.py <path>，任何高危发现即报告为不安全并停止。
【成功账本】 创建开始时运行 python3 scripts/success_ledger.py new-run，保留该 ID 贯穿验证，并记录 references/product-success.md 中描述的本地生命周期事件。记录不存储任何工作流内容，且不得阻碍创建；遵循 ASC_SUCCESS_LEDGER=off。
【输出】 一个自包含技能，包含指令、必要时可用的脚本、评估、维护工具、插件清单和跨平台安装器。安装后用户以 /skill-name 调用。
【适用场景】 需要把重复性工作流（如销售数据清洗与报告、发票处理、库存查询、合规审计等）自动化为可复用技能的场景；需要评估第三方技能安全性的场景；需要评估 MCP 服务器可构建能力的场景。
【限制】 技能只有在代表性运行成功后才算创建成功。若安全运行需要凭证、不可用数据或对后果性副作用的许可，应使用 "verification-blocked" 交接而非声称成功。安全扫描通过仅表示没有已知模式匹配，不代表安全证明。生成的管道脚本无法在运行时调用 MCP 工具。该工具的具体收费、价格与平台支持信息暂未提供。