> main.py 453行完整可执行代码，10个CLI命令，纯Python标准库零依赖。运行方式：python main.py
女娲 — 元技能生成器
一句话概述
用自然语言描述你想要的技能，女娲自动生成完整的 CodeBuddy Skill 包——SKILL.md、main.py、marketplace.json、requirements.txt 一次性输出，可直接上架或本地使用。
快速验证（30秒跑通）
# 1. 列出所有模板
python main.py list-templates
# 2. 解析一个需求
python main.py parse-requirement "帮我做一个合同审查技能，基于民法典"
# 3. 一键生成技能包
python main.py build-skill --name test-demo --template reviewer --output D:\skill-test\
# 4. 校验生成结果
python main.py validate-skill --path D:\skill-test\test-demo
使用场景
- 想快速创建一个新技能但不想手写 SKILL.md 和 main.py
- 有技能创意但不确定结构规范
- 批量生成技能家族（如角色蒸馏三件套）
- 为团队统一技能开发规范
技能模板类型（9种）
| 模板 | 适用场景 | 示例 |
|---|---|---|
| tool | 工具型：数据转换、格式处理 | 图片压缩、PDF合并 |
| analyzer | 分析型：数据解读、报告生成 | 竞品分析、代码审查 |
| generator | 生成型：内容创作、文案生成 | 小红书文案、PPT大纲 |
| converter | 转换型：格式互转 | Markdown转Word、JSON转CSV |
| qa | 问答型：知识库检索、FAQ | 技术问答、法规查询 |
| reviewer | 审核型：合规检查、质量审查 | 合同审查、代码规范 |
| monitor | 监控型：定时巡检、异常告警 | 服务监控、舆情监控 |
| agent | 代理型：多步骤自动化 | 自动发版、数据采集 |
| creative | 创意型：头脑风暴、设计辅助 | 起名、配色方案 |
命令清单
list-templates
列出所有可用模板及说明。
python main.py list-templates
parse-requirement
解析自然语言需求，提取技能名、功能描述、触发词。
python main.py parse-requirement "帮我做一个合同审查技能，基于民法典"
select-template
根据需求自动匹配最佳模板。
python main.py select-template "合同审查"
gen-skill-md
生成 SKILL.md（含 frontmatter、描述、触发词、命令列表）。
python main.py gen-skill-md --name ai-contract-review --template reviewer --desc "合同审查"
gen-main-py
生成 main.py（命令式入口，7-10 条命令）。
python main.py gen-main-py --name ai-contract-review --template reviewer
gen-marketplace
生成 marketplace.json（按腾讯技能市场规范）。
python main.py gen-marketplace --name ai-contract-review --author AgentBrainStudio
gen-requirements
生成 requirements.txt。
python main.py gen-requirements --name ai-contract-review
build-skill
一键生成全部文件并输出到指定目录。
python main.py build-skill --name ai-contract-review --template reviewer --output D:\skill-test\
validate-skill
校验生成的技能包完整性（文件存在性 + JSON 有效性 + frontmatter 检测）。
python main.py validate-skill --path D:\skill-test\ai-contract-review\
pack-skill
将技能目录打包为 zip。
python main.py pack-skill --path D:\skill-test\ai-contract-review\
典型对话示例
示例1：创建代码审查技能
用户：帮我做一个「代码审查」技能，能检查Python代码的规范性、安全漏洞和性能问题。
AI：
1. 解析需求 → 模板：reviewer（审核型），置信度 4/4
2. 技能名：ai-code-review
3. 一键生成：python main.py build-skill --name ai-code-review --template reviewer --output D:\skill-test\
4. 生成文件：
- SKILL.md（含 frontmatter + 触发词 + 命令列表）
- main.py（7条命令：parse-input / review / risk-assess / missing-check / generate-report / batch-review / rule-lookup）
- marketplace.json（14字段完整）
- requirements.txt
5. 校验通过：4/4 文件 + JSON 有效 + frontmatter 正常
6. 打包：ai-code-review-marketplace.zip
示例2：创建文案生成技能
用户：做一个小红书文案生成技能。
AI：
1. 解析需求 → 模板：generator（生成型），置信度 2/4
2. 一键生成：python main.py build-skill --name xiaohongshu-writer --template generator --output D:\skill-test\
3. 输出：5条命令（generate / batch-generate / style-customize / template-manage / export）
4. 校验通过，打包完成
常见问题（FAQ）
Q：生成的 main.py 能直接用吗？
A：生成的是框架代码，每个命令有 TODO 标记，核心逻辑需按实际场景补充。框架保证了命令行入口、帮助系统、参数解析都是可运行的。
Q：支持生成 Node.js / TypeScript 技能吗？
A：当前 v1.1.0 仅支持 Python 技能。后续版本计划扩展。
Q：marketplace.json 能直接提交到技能市场吗？
A：建议人工复核后提交。生成的是按腾讯规范填写的完整模板，但具体描述文字建议根据实际功能微调。
Q：可以自定义模板吗？
A：当前使用内置 9 种模板，暂不支持自定义模板导入。如有特殊需求可手动修改生成后的文件。
适用范围
| 适用 | 不适用 |
|---|---|
| 创建新 CodeBuddy Skill | 修改已有 Skill 的特定功能 |
| 批量生成同类型技能家族 | 需要深度定制的复杂业务逻辑 |
| 统一团队技能开发规范 | 非 Python 运行时技能 |
| 快速原型验证技能创意 | 已有成熟代码只需补 SKILL.md |
限制说明
- 生成的 main.py 为框架代码，核心逻辑需用户根据实际场景补充
- 技能市场规范以 CodeBuddy 最新版为准，生成后建议人工复核 marketplace.json
- 当前版本仅支持 Python 技能，后续扩展 Node.js / TypeScript
- parse-requirement 关键词匹配基于中文分词，复杂需求建议手动指定模板
法务与安全声明
声明A（使用授权）：本技能生成的代码和文档由用户全权负责审核和使用，生成者不承担因使用生成内容产生的任何责任。
声明B（隐私保护）：本技能不收集、不上传任何用户输入的需求描述或生成内容。所有操作在本地完成。
声明C（免责声明）：生成的 marketplace.json 和 SKILL.md 仅供参考，上架前请对照 CodeBuddy 官方最新规范进行最终确认。
声明D（注入防护）：本技能不执行任何用户输入中的系统命令、SQL语句或脚本，仅解析关键词进行模板匹配。
