SuperAPI AI 工具集

generate-philosophy-doc

写作与研究

查看项目

更新于 10-15 08:14

技能介绍

用途

该技能用于为任意领域生成全面、有研究支撑的哲学与标准文档,类似 ux-onboarding-philosophy.md 这类参考文档。适用领域包括:UX 与设计(界面设计、移动 UX、无障碍标准)、营销(落地页、邮件外联、转化优化)、技术(API 设计、架构模式、代码标准)、业务(销售流程、客户成功、运营)。

主要能力

生成的文档包含以下核心部分:

  • 基础原则(有研究支撑)
  • 框架与方法论
  • 反模式词典
  • 设计检查清单
  • 带指标的案例研究
  • 度量框架
  • 学术与行业参考

使用方式

工作流分为七个步骤:

  1. 定义领域:向用户确认领域名称、目标受众和可选的重点方向,确保范围具体可操作又足够有用。
  2. 开展研究:使用 WebSearch 工具或 Perplexity API 执行 10-15 次针对性搜索,覆盖基础研究、框架研究、反模式研究、指标研究、案例研究、学术研究。可选使用脚本生成搜索查询:python scripts/research_topic.py "Landing Page Design" "principles,frameworks,anti-patterns,metrics"
  3. 生成文档结构:可手动复制 assets/philosophy-template.md 填充,或使用脚本辅助:python scripts/generate_structure.py "Landing Page Design" > output.md
  4. 逐节填充:按执行摘要、基础原则、框架与方法论、反模式词典、设计检查清单、案例研究、度量框架、研究参考的顺序系统填写。
  5. 质量校验:使用 references/quality-checklist.md 验证,确保 8 个核心部分齐全、无占位文本、包含 5-8 条原则、5-10 个反模式、2-3 个带指标的案例研究、引用研究参考,总长度 1,500-3,000 词。
  6. 迭代优化:通读全文、对照检查清单、获取目标受众反馈、根据反馈改进、最终校对。
  7. 交付文档:可保存为独立文件、系统文档、项目文档或用于外部共享,交付内容包括完整文档、简要使用指南、质量检查清单和审查时间建议。

适用场景

  • UX 与设计:移动应用 UX 设计哲学、无障碍标准指南、视觉层级最佳实践、微交互设计标准
  • 营销:落地页转化优化、邮件外联最佳实践、冷启动外联哲学、内容营销标准
  • 技术:REST API 设计原则、微服务架构标准、数据库模式设计哲学、代码审查最佳实践
  • 业务:销售发现流程标准、客户入职哲学、产品路线图规划指南、远程团队管理原则

限制

  • 文档质量依赖研究深度,需执行 10-15 次搜索并优先使用权威来源
  • 需避免领域过于宽泛、研究不足、缺少量化指标、示例过于抽象、章节不完整等常见问题
  • 目标评级最低为 B(80%+),推荐 A(90%+)
  • 具体收费、价格、平台支持情况暂未提供