@rotifer/playground 0.8.1 → 0.8.5

package/genes/prompt-engineer/SKILL.md

@@ -1,411 +0,0 @@
----
-name: prompt-engineer
-description: Design and optimize AI prompts for maximum effectiveness and cost efficiency. Create structured outputs, few-shot examples, and prompt templates. Use when writing prompts, designing AI features, optimizing token usage, or when the user mentions prompt, system message, or AI output format.
----
-
-# Prompt Engineer (提示词工程师)
-
-**Goal**: 设计高效、稳定、低成本的 AI 提示词，确保输出质量和一致性。
-
----
-
-## Pre-Design Checklist
-
-```
-Prompt Design Check:
-- [ ] 任务目标明确？(做什么)
-- [ ] 输出格式定义？(JSON/Markdown/自然语言)
-- [ ] 有 Few-shot 示例？
-- [ ] Token 成本评估？
-- [ ] 边界情况处理？(拒绝/不确定/超长)
-```
-
----
-
-## 1. Prompt Structure (提示词结构)
-
-### 标准模板
-
-```typescript
-const PROMPT_TEMPLATE = `
-# Role
-{角色定义 - 1-2句}
-
-# Task
-{任务描述 - 清晰具体}
-
-# Context
-{背景信息 - 仅包含必要信息}
-
-# Output Format
-{输出格式 - 结构化定义}
-
-# Examples
-{Few-shot 示例 - 2-3个}
-
-# Constraints
-{约束条件 - 禁止事项}
-
-# Input
-{用户输入}
-`
-```
-
-### 结构化输出 (JSON Schema)
-
-```typescript
-// 使用 Zod 定义 Schema
-import { z } from 'zod'
-
-const AnalysisSchema = z.object({
-  summary: z.string().describe('一句话总结'),
-  keyPoints: z.array(z.string()).max(5).describe('关键要点'),
-  sentiment: z.enum(['positive', 'negative', 'neutral']),
-  confidence: z.number().min(0).max(1),
-})
-
-// Vercel AI SDK 用法
-import { generateObject } from 'ai'
-
-const result = await generateObject({
-  model: openai('gpt-4o'),
-  schema: AnalysisSchema,
-  prompt: userInput,
-})
-```
-
-### OpenAI Function Calling
-
-```typescript
-const tools = [{
-  type: 'function',
-  function: {
-    name: 'extract_entities',
-    description: 'Extract named entities from text',
-    parameters: {
-      type: 'object',
-      properties: {
-        persons: { type: 'array', items: { type: 'string' } },
-        organizations: { type: 'array', items: { type: 'string' } },
-        locations: { type: 'array', items: { type: 'string' } },
-      },
-      required: ['persons', 'organizations', 'locations'],
-    },
-  },
-}]
-```
-
----
-
-## 2. Prompt Patterns (提示词模式)
-
-### Chain of Thought (CoT)
-
-```
-Let's think step by step:
-1. First, analyze...
-2. Then, consider...
-3. Finally, conclude...
-```
-
-### Few-Shot Learning
-
-```typescript
-const FEW_SHOT_PROMPT = `
-# Task
-Classify the sentiment of the text.
-
-# Examples
-Input: "This product exceeded my expectations!"
-Output: { "sentiment": "positive", "confidence": 0.95 }
-
-Input: "Terrible experience, never buying again."
-Output: { "sentiment": "negative", "confidence": 0.92 }
-
-Input: "It works as described."
-Output: { "sentiment": "neutral", "confidence": 0.78 }
-
-# Input
-${userInput}
-`
-```
-
-### Role Prompting
-
-```typescript
-const EXPERT_ROLE = `
-You are a senior blockchain security auditor with 10+ years of experience.
-You specialize in identifying vulnerabilities in smart contracts.
-You are methodical, thorough, and always explain your reasoning.
-`
-```
-
-### Output Constraints
-
-```typescript
-const OUTPUT_CONSTRAINTS = `
-# Constraints
-- Response must be valid JSON
-- Maximum 3 key points
-- Each point under 50 words
-- Use professional tone
-- If unsure, say "Unable to determine" instead of guessing
-`
-```
-
----
-
-## 3. Token Optimization (成本优化)
-
-### 精简原则
-
-| Before | After | 节省 |
-|--------|-------|------|
-| "I want you to..." | (删除) | ~5 tokens |
-| "Please provide..." | (直接说) | ~3 tokens |
-| 重复的上下文 | 引用变量 | ~50% |
-| 完整示例 x 5 | 精选示例 x 2 | ~60% |
-
-### 动态上下文
-
-```typescript
-// 根据任务复杂度选择示例数量
-function buildPrompt(task: string, complexity: 'low' | 'medium' | 'high') {
-  const exampleCount = { low: 1, medium: 2, high: 3 }[complexity]
-  const examples = EXAMPLES.slice(0, exampleCount)
-  
-  return `
-    ${SYSTEM_PROMPT}
-    ${examples.map(formatExample).join('\n')}
-    ${task}
-  `
-}
-```
-
-### 压缩长文本
-
-```typescript
-// 先用小模型压缩，再用大模型分析
-async function analyzeDocument(doc: string) {
-  // Step 1: 压缩 (便宜)
-  const summary = await generateText({
-    model: openai('gpt-4o-mini'),
-    prompt: `Summarize in 200 words: ${doc}`,
-  })
-  
-  // Step 2: 深度分析 (贵)
-  const analysis = await generateObject({
-    model: openai('gpt-4o'),
-    schema: AnalysisSchema,
-    prompt: `Analyze: ${summary}`,
-  })
-  
-  return analysis
-}
-```
-
----
-
-## 4. Prompt Templates Library
-
-### 内容生成
-
-```typescript
-const CONTENT_GENERATION = `
-# Role
-You are a professional content writer.
-
-# Task
-Write a {contentType} about {topic}.
-
-# Requirements
-- Tone: {tone}
-- Length: {wordCount} words
-- Audience: {audience}
-- Include: {mustInclude}
-
-# Format
-Return as markdown with proper headings.
-`
-```
-
-### 数据提取
-
-```typescript
-const DATA_EXTRACTION = `
-# Task
-Extract structured data from the following text.
-
-# Output Schema
-{
-  "field1": "description",
-  "field2": "description",
-  ...
-}
-
-# Rules
-- If a field is not found, use null
-- Dates in ISO 8601 format
-- Numbers without units
-
-# Text
-{inputText}
-`
-```
-
-### 代码生成
-
-```typescript
-const CODE_GENERATION = `
-# Role
-You are a senior {language} developer.
-
-# Task
-{taskDescription}
-
-# Requirements
-- Use {framework}
-- Follow {styleGuide}
-- Include error handling
-- Add TypeScript types
-
-# Output
-Return only the code, no explanations.
-Use \`\`\`{language} code blocks.
-`
-```
-
-### 分类/判断
-
-```typescript
-const CLASSIFICATION = `
-# Task
-Classify the input into one of the following categories:
-{categories}
-
-# Rules
-- Choose exactly one category
-- Include confidence score (0-1)
-- If unsure (confidence < 0.6), choose "unknown"
-
-# Output Format
-{ "category": "...", "confidence": 0.XX, "reasoning": "..." }
-
-# Input
-{input}
-`
-```
-
----
-
-## 5. Testing & Iteration
-
-### Prompt 测试矩阵
-
-| 测试维度 | 检查点 |
-|----------|--------|
-| 正常输入 | 预期输出正确 |
-| 边界输入 | 空/超长/特殊字符 |
-| 对抗输入 | Prompt 注入尝试 |
-| 一致性 | 相同输入多次运行 |
-
-### 版本管理
-
-```typescript
-// prompts/v1/analyzer.ts
-export const ANALYZER_PROMPT_V1 = `...`
-
-// prompts/v2/analyzer.ts (优化版)
-export const ANALYZER_PROMPT_V2 = `...`
-
-// prompts/index.ts
-export { ANALYZER_PROMPT_V2 as ANALYZER_PROMPT } from './v2/analyzer'
-```
-
-### A/B 测试
-
-```typescript
-async function runPromptABTest(input: string) {
-  const [resultA, resultB] = await Promise.all([
-    generateWithPrompt(PROMPT_V1, input),
-    generateWithPrompt(PROMPT_V2, input),
-  ])
-  
-  logToAnalytics({
-    input,
-    resultA,
-    resultB,
-    // 人工评估或自动评估
-  })
-}
-```
-
----
-
-## 6. Common Mistakes (常见错误)
-
-### ❌ 避免
-
-```typescript
-// 太模糊
-"Help me with this text"
-
-// 太啰嗦
-"I would really appreciate it if you could kindly..."
-
-// 无结构
-"Analyze this and give me insights"
-
-// 无示例
-"Extract the data" (什么格式？)
-```
-
-### ✅ 正确
-
-```typescript
-// 明确具体
-"Extract all company names and their founding years"
-
-// 直接
-"Summarize in 3 bullet points"
-
-// 结构化
-"Return JSON: { companies: [{ name, year }] }"
-
-// 有示例
-"Example: 'Apple founded 1976' → { name: 'Apple', year: 1976 }"
-```
-
----
-
-## Quick Reference
-
-### 模型选择
-
-| 任务类型 | 推荐模型 | 理由 |
-|----------|----------|------|
-| 简单分类 | gpt-4o-mini | 快、便宜 |
-| 复杂推理 | gpt-4o / claude-3.5-sonnet | 质量高 |
-| 代码生成 | gpt-4o / claude-3.5-sonnet | 准确性 |
-| 长文本 | claude-3.5-sonnet | 200k context |
-
-### Token 估算
-
-```
-英文: ~4 chars = 1 token
-中文: ~1.5 chars = 1 token
-代码: ~3 chars = 1 token
-```
-
-### 常用 System Prompts
-
-```typescript
-// 严格 JSON
-"You are a JSON generator. Output valid JSON only, no markdown."
-
-// 简洁回答
-"Be concise. Answer in 1-2 sentences maximum."
-
-// 拒绝回答
-"If you cannot answer confidently, respond with: { error: 'Unable to determine' }"
-```

package/genes/prompt-engineer/phenotype.json

@@ -1,28 +0,0 @@
-{
-  "domain": "ai.prompting",
-  "description": "Design and optimize AI prompts for maximum effectiveness and cost efficiency. Create structured outputs, few-shot examples, and prompt templates. Use when writing prompts, designing AI features, optimizing token usage, or when the user mentions prompt, system message, or AI output format.",
-  "inputSchema": {
-    "type": "object",
-    "properties": {
-      "prompt": {
-        "type": "string"
-      }
-    },
-    "required": []
-  },
-  "outputSchema": {
-    "type": "object",
-    "properties": {
-      "result": {
-        "type": "string"
-      }
-    }
-  },
-  "dependencies": [],
-  "version": "0.1.0",
-  "author": "rotifer-team",
-  "createdAt": 1771939418611,
-  "fidelity": "Wrapped",
-  "transparency": "Open",
-  "source": "skill"
-}

package/genes/prompt-review-perf/.gene-manifest.json

@@ -1,8 +0,0 @@
-{
-  "geneId": "41b58d584a54b17faa96829c39b5e6e4c5cb71af2adfba6ac670bb96ae8c9bba",
-  "name": "prompt-review-perf",
-  "domain": "prompt.code-review",
-  "fidelity": "Wrapped",
-  "wrappedAt": "2026-03-24T01:54:54.000Z",
-  "fromSkill": null
-}

package/genes/prompt-review-perf/phenotype.json

@@ -1,61 +0,0 @@
-{
-  "domain": "prompt.code-review",
-  "description": "Code review gene specialized in performance issue detection. Identifies N+1 queries, unnecessary re-renders, memory leaks, blocking operations, inefficient algorithms, and bundle size issues. Part of the Code Review Assistant 3×2 arena competition.",
-  "inputSchema": {
-    "type": "object",
-    "properties": {
-      "code": { "type": "string", "description": "Source code to review" },
-      "language": { "type": "string", "description": "Programming language" },
-      "context": { "type": "string", "description": "File path or component context" }
-    },
-    "required": ["code"]
-  },
-  "outputSchema": {
-    "type": "object",
-    "properties": {
-      "findings": {
-        "type": "array",
-        "items": {
-          "type": "object",
-          "properties": {
-            "severity": { "type": "string", "enum": ["critical", "warning", "info"] },
-            "category": { "type": "string" },
-            "message": { "type": "string" },
-            "line": { "type": "integer" },
-            "fix": { "type": "string" },
-            "impact": { "type": "string", "description": "Estimated performance impact" }
-          }
-        }
-      },
-      "summary": { "type": "string" },
-      "overallImpact": { "type": "string", "enum": ["high", "medium", "low", "negligible"] }
-    }
-  },
-  "llmRequirements": {
-    "templateFormat": "mustache",
-    "templateVariables": ["code", "language", "context"],
-    "targetModels": ["claude-3", "gpt-4"],
-    "minContextWindow": 8192,
-    "expectedOutputFormat": "json",
-    "temperatureHint": 0.2,
-    "maxOutputTokens": 4096,
-    "systemPromptPath": "system-prompt.md",
-    "chainOfThought": true
-  },
-  "fitnessConfig": {
-    "evaluationMethod": "template-quality",
-    "dimensions": {
-      "detectionRate": { "weight": 0.35, "description": "Fraction of known perf issues found" },
-      "falsePositiveRate": { "weight": 0.25, "description": "Precision of findings" },
-      "responseQuality": { "weight": 0.20, "description": "Actionability of optimization suggestions" },
-      "templateValidity": { "weight": 0.10, "description": "Template renders without error" },
-      "resourceEfficiency": { "weight": 0.10, "description": "Token efficiency" }
-    }
-  },
-  "dependencies": [],
-  "version": "0.1.0",
-  "author": "rotifer-team",
-  "fidelity": "Wrapped",
-  "transparency": "Open",
-  "source": "development-genome"
-}

package/genes/prompt-review-perf/system-prompt.md

@@ -1,22 +0,0 @@
-You are a performance-focused code reviewer. Your mission is to find performance bottlenecks and optimization opportunities.
-
-Focus areas (in priority order):
-1. **Database queries**: N+1 queries, missing indexes, unbounded SELECTs, unnecessary JOINs
-2. **Memory**: leaks, unbounded caches, large object retention, missing cleanup
-3. **Async/blocking**: synchronous operations in async context, missing concurrency, sequential awaits that could be parallel
-4. **Rendering**: unnecessary re-renders (React), layout thrashing, unoptimized images
-5. **Algorithms**: O(n²) when O(n log n) exists, redundant computation, missing memoization
-6. **Bundle/payload**: unused imports, large dependencies for small tasks, missing tree-shaking
-7. **Network**: missing caching headers, redundant API calls, large payloads
-
-For each finding, provide:
-- `severity`: "critical" (measurable impact >100ms), "warning" (noticeable), "info" (micro-optimization)
-- `category`: short tag (e.g., "n-plus-1", "memory-leak", "blocking-io")
-- `message`: clear description of the issue
-- `line`: approximate line number
-- `fix`: concrete optimization with expected improvement
-- `impact`: estimated performance impact (e.g., "~200ms savings per request")
-
-Focus on findings with measurable impact. Avoid premature optimization suggestions.
-
-Output valid JSON matching the output schema.

package/genes/prompt-review-readability/.gene-manifest.json

@@ -1,8 +0,0 @@
-{
-  "geneId": "ff84e0a13591b78c08dce76c0998b60c725958380b45459ad933cd211f7dae68",
-  "name": "prompt-review-readability",
-  "domain": "prompt.code-review",
-  "fidelity": "Wrapped",
-  "wrappedAt": "2026-03-24T01:54:54.000Z",
-  "fromSkill": null
-}

package/genes/prompt-review-readability/phenotype.json

@@ -1,60 +0,0 @@
-{
-  "domain": "prompt.code-review",
-  "description": "Code review gene specialized in readability and maintainability. Identifies unclear naming, missing documentation, excessive complexity, inconsistent patterns, and code smell. Part of the Code Review Assistant 3×2 arena competition.",
-  "inputSchema": {
-    "type": "object",
-    "properties": {
-      "code": { "type": "string", "description": "Source code to review" },
-      "language": { "type": "string", "description": "Programming language" },
-      "context": { "type": "string", "description": "File path or component context" }
-    },
-    "required": ["code"]
-  },
-  "outputSchema": {
-    "type": "object",
-    "properties": {
-      "findings": {
-        "type": "array",
-        "items": {
-          "type": "object",
-          "properties": {
-            "severity": { "type": "string", "enum": ["critical", "warning", "info"] },
-            "category": { "type": "string" },
-            "message": { "type": "string" },
-            "line": { "type": "integer" },
-            "fix": { "type": "string" }
-          }
-        }
-      },
-      "summary": { "type": "string" },
-      "readabilityScore": { "type": "number", "description": "0-10 readability score" }
-    }
-  },
-  "llmRequirements": {
-    "templateFormat": "mustache",
-    "templateVariables": ["code", "language", "context"],
-    "targetModels": ["claude-3", "gpt-4"],
-    "minContextWindow": 8192,
-    "expectedOutputFormat": "json",
-    "temperatureHint": 0.3,
-    "maxOutputTokens": 4096,
-    "systemPromptPath": "system-prompt.md",
-    "chainOfThought": false
-  },
-  "fitnessConfig": {
-    "evaluationMethod": "template-quality",
-    "dimensions": {
-      "detectionRate": { "weight": 0.30, "description": "Coverage of known readability issues" },
-      "falsePositiveRate": { "weight": 0.25, "description": "Precision — avoid pedantic nitpicks" },
-      "responseQuality": { "weight": 0.25, "description": "Quality of rewrite suggestions" },
-      "templateValidity": { "weight": 0.10, "description": "Template renders without error" },
-      "resourceEfficiency": { "weight": 0.10, "description": "Token efficiency" }
-    }
-  },
-  "dependencies": [],
-  "version": "0.1.0",
-  "author": "rotifer-team",
-  "fidelity": "Wrapped",
-  "transparency": "Open",
-  "source": "development-genome"
-}

package/genes/prompt-review-readability/system-prompt.md

@@ -1,21 +0,0 @@
-You are a readability-focused code reviewer. Your mission is to improve code clarity and maintainability.
-
-Focus areas (in priority order):
-1. **Naming**: unclear variable/function/class names, abbreviations, misleading names
-2. **Complexity**: functions >30 lines, nesting >3 levels, cyclomatic complexity >10
-3. **Documentation**: missing JSDoc/docstrings for public APIs, outdated comments
-4. **Patterns**: inconsistent error handling, mixed paradigms, anti-patterns
-5. **Structure**: god functions, missing abstractions, tight coupling
-6. **Dead code**: unused variables, unreachable branches, commented-out code
-7. **Consistency**: mixed naming conventions, inconsistent formatting within file
-
-For each finding, provide:
-- `severity`: "critical" (blocks understanding), "warning" (slows comprehension), "info" (style preference)
-- `category`: short tag (e.g., "naming", "complexity", "dead-code")
-- `message`: clear description of the readability issue
-- `line`: approximate line number
-- `fix`: concrete rewrite suggestion (show before/after when possible)
-
-Respect the codebase's existing style. Don't enforce personal preferences — focus on objective clarity improvements.
-
-Output valid JSON matching the output schema. Include a `readabilityScore` from 0 (unreadable) to 10 (exemplary).

package/genes/prompt-review-security/.gene-manifest.json

@@ -1,8 +0,0 @@
-{
-  "geneId": "0376427b53f9d478290a5908646720cb2772cca42981c85a84448cfa6eefca00",
-  "name": "prompt-review-security",
-  "domain": "prompt.code-review",
-  "fidelity": "Wrapped",
-  "wrappedAt": "2026-03-24T01:54:54.000Z",
-  "fromSkill": null
-}

package/genes/prompt-review-security/phenotype.json

@@ -1,60 +0,0 @@
-{
-  "domain": "prompt.code-review",
-  "description": "Code review gene specialized in security vulnerability detection. Identifies prompt injection, private key exposure, path traversal, SSRF, input validation gaps, and supply chain risks. Part of the Code Review Assistant 3×2 arena competition.",
-  "inputSchema": {
-    "type": "object",
-    "properties": {
-      "code": { "type": "string", "description": "Source code to review" },
-      "language": { "type": "string", "description": "Programming language" },
-      "context": { "type": "string", "description": "File path or component context" }
-    },
-    "required": ["code"]
-  },
-  "outputSchema": {
-    "type": "object",
-    "properties": {
-      "findings": {
-        "type": "array",
-        "items": {
-          "type": "object",
-          "properties": {
-            "severity": { "type": "string", "enum": ["critical", "warning", "info"] },
-            "category": { "type": "string" },
-            "message": { "type": "string" },
-            "line": { "type": "integer" },
-            "fix": { "type": "string" }
-          }
-        }
-      },
-      "summary": { "type": "string" },
-      "riskLevel": { "type": "string", "enum": ["high", "medium", "low", "none"] }
-    }
-  },
-  "llmRequirements": {
-    "templateFormat": "mustache",
-    "templateVariables": ["code", "language", "context"],
-    "targetModels": ["claude-3", "gpt-4"],
-    "minContextWindow": 8192,
-    "expectedOutputFormat": "json",
-    "temperatureHint": 0.1,
-    "maxOutputTokens": 4096,
-    "systemPromptPath": "system-prompt.md",
-    "chainOfThought": true
-  },
-  "fitnessConfig": {
-    "evaluationMethod": "template-quality",
-    "dimensions": {
-      "detectionRate": { "weight": 0.35, "description": "Fraction of known issues found in test corpus" },
-      "falsePositiveRate": { "weight": 0.25, "description": "1 - (false positives / total findings), higher is better" },
-      "responseQuality": { "weight": 0.20, "description": "Actionability of fix suggestions" },
-      "templateValidity": { "weight": 0.10, "description": "Template renders without error" },
-      "resourceEfficiency": { "weight": 0.10, "description": "Token efficiency of rendered prompt" }
-    }
-  },
-  "dependencies": [],
-  "version": "0.1.0",
-  "author": "rotifer-team",
-  "fidelity": "Wrapped",
-  "transparency": "Open",
-  "source": "development-genome"
-}