Community研究与数据分析github.com

softaworks/gepetto

通过研究、利益相关者访谈和多LLM审查创建详细的分节实施计划。适用于需要全面预实现分析的特性规划。

gepetto 是什么?

该技能(softaworks/gepetto)旨在协助开发者制定结构化的实施计划,特别适用于需要深入分析和多方验证的复杂功能规划。它通过自动进行预实现研究、模拟利益相关者访谈以及利用多LLM(大语言模型)协同审查,生成详尽且分节的设计文档。技能的主要优势在于能够系统性地识别潜在风险、收集需求并优化方案,从而减少实施阶段的返工。它支持在Claude等AI辅助开发环境中使用,其核心工作流程包括:启动时引导用户明确目标,然后自动执行一系列分析步骤,最终输出一份包含背景、需求、设计、风险、任务分解等模块的完整计划。这使得开发者可以更专注于决策而非文档编写。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/softaworks/agent-toolkit/tree/main/skills/gepetto

Installed? Explore more 研究与数据分析 skills: affaan-m/uspto-database, affaan-m/scholar-evaluation, affaan-m/literature-review · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

gepetto 是做什么的?

通过研究、利益相关者访谈和多LLM审查创建详细的分节实施计划。适用于需要全面预实现分析的特性规划。

概述

gepetto 是一个用于生成结构化实施计划的技能。它模拟了软件工程中完整的预实现阶段,包括:

  • 领域研究:分析现有代码库或相关上下文。
  • 利益相关者访谈:模拟与不同角色的访谈以收集需求。
  • 多LLM审查:利用多个LLM实例评估计划质量。
  • 分节输出:生成包含背景、设计、风险、任务分解的 Markdown 文档。

适用场景

  • 规划中等至大型功能时,需要系统性分析。
  • 当需求不清晰或存在多个冲突目标时。
  • 团队希望预先识别实现风险。

使用方法

  1. 在支持该技能的AI工具(如Claude Code)中激活技能。
  2. 描述你想要规划的功能。
  3. 技能将自动执行以下步骤:
    • 分析输入并启动研究。
    • 模拟访谈收集需求。
    • 生成草稿计划。
    • 调用多种LLM进行审查。
    • 输出最终计划。

输出格式

技能输出一个结构化的 Markdown 文档,包含以下部分:

  • 标题和元数据
  • 背景与目标
  • 利益相关者摘要
  • 技术设计
  • 风险评估
  • 实施任务
  • 验收标准

平台支持

  • 适用于支持可执行技能定义的AI代理环境。
  • 已测试与 Claude Code 兼容。

示例

# 实施计划:用户认证模块

## 背景
用户报告登录流程存在延迟…

## 利益相关者
- 产品经理:希望支持SSO。
- 安全团队:需要MFA。

## 设计
使用OAuth 2.0 + 双因素认证。

## 任务
1. 更新依赖库。
2. 实现SSO端点。
3. 集成MFA提供程序。

配置

技能默认行为可通过以下环境变量调整(可选):

  • GEPPETTO_LLM_COUNT:用于审查的LLM实例数量(默认:3)。
  • GEPPETTO_INTERVIEW_STEPS:是否启用模拟访谈(默认:true)。

备注

  • 技能不修改任何外部系统;输出完全文本。
  • 依赖LLM的推理能力;结果质量取决于输入上下文。
  • 对于高度专业化的领域,建议人工审核输出。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

softaworks/agent-md-refactor

Refactor bloated AGENTS.md, CLAUDE.md, or similar agent instruction files to follow progressive disclosure principles. Splits monolithic files into organized, linked documentation.

softaworks/c4-architecture

Generate architecture documentation using C4 model Mermaid diagrams. Use when asked to create architecture diagrams, document system architecture, visualize software structure, create C4 diagrams, or generate context/container/component/deployment diagrams. Triggers include "architecture diagram", "C4 diagram", "system context", "container diagram", "component diagram", "deployment diagram", "document architecture", "visualize architecture".

softaworks/codex

Use when the user asks to run Codex CLI (codex exec, codex resume) or references OpenAI Codex for code analysis, refactoring, or automated editing. Uses GPT-5.2 by default for state-of-the-art software engineering.

softaworks/command-creator

This skill should be used when creating a Claude Code slash command. Use when users ask to "create a command", "make a slash command", "add a command", or want to document a workflow as a reusable command. Essential for creating optimized, agent-executable slash commands with proper structure and best practices.

softaworks/commit-work

Create high-quality git commits: review/stage intended changes, split into logical commits, and write clear commit messages (including Conventional Commits). Use when the user asks to commit, craft a commit message, stage changes, or split work into multiple commits.

softaworks/crafting-effective-readmes

Use when writing or improving README files. Not all READMEs are the same — provides templates and guidance matched to your audience and project type.

softaworks/daily-meeting-update

Interactive daily standup/meeting update generator. Use when user says 'daily', 'standup', 'scrum update', 'status update', 'what did I do yesterday', 'prepare for meeting', 'morning update', or 'team sync'. Pulls activity from GitHub, Jira, and Claude Code session history. Conducts 4-question interview (yesterday, today, blockers, discussion topics) and generates formatted Markdown update.

softaworks/database-schema-designer

Design robust, scalable database schemas for SQL and NoSQL databases. Provides normalization guidelines, indexing strategies, migration patterns, constraint design, and performance optimization. Ensures data integrity, query performance, and maintainable data models.

softaworks/dependency-updater

Smart dependency management for any language. Auto-detects project type, applies safe updates automatically, prompts for major versions, diagnoses and fixes dependency issues.

softaworks/difficult-workplace-conversations

Structured approach to workplace conflicts, performance discussions, and challenging feedback using preparation-delivery-followup framework. Use when preparing for tough conversations, addressing conflicts, giving critical feedback, or navigating sensitive workplace discussions.

softaworks/domain-name-brainstormer

Generates creative domain name ideas for your project and checks availability across multiple TLDs (.com, .io, .dev, .ai, etc.). Saves hours of brainstorming and manual checking.

softaworks/feedback-mastery

Navigate difficult conversations and deliver constructive feedback using structured frameworks. Covers the Preparation-Delivery-Follow-up model and Situation-Behavior-Impact (SBI) feedback technique. Use when preparing for difficult conversations, giving feedback, or managing conflicts.

softaworks/game-changing-features

Find 10x product opportunities and high-leverage improvements. Use when user wants strategic product thinking, mentions '10x', wants to find high-impact features, or says 'what would make this 10x better', 'product strategy', or 'what should we build next'.

softaworks/gemini

Use when the user asks to run Gemini CLI for code review, plan review, or big context (>200k) processing. Ideal for comprehensive analysis requiring large context windows. Uses Gemini 3 Pro by default for state-of-the-art reasoning and coding.

softaworks/humanizer

Remove signs of AI-generated writing from text. Use when editing or reviewing text to make it sound more natural and human-written. Based on Wikipedia's comprehensive "Signs of AI writing" guide. Detects and fixes patterns including: inflated symbolism, promotional language, superficial -ing analyses, vague attributions, em dash overuse, rule of three, AI vocabulary words, negative parallelisms, and excessive conjunctive phrases. Credits: Original skill by @blader - https://github.com/blader/humanizer

softaworks/lesson-learned

Analyze recent code changes via git history and extract software engineering lessons. Use when the user asks 'what is the lesson here?', 'what can I learn from this?', 'engineering takeaway', 'what did I just learn?', 'reflect on this code', or wants to extract principles from recent work.

softaworks/marp-slide

Create professional Marp presentation slides with 7 beautiful themes (default, minimal, colorful, dark, gradient, tech, business). Use when users request slide creation, presentations, or Marp documents. Supports custom themes, image layouts, and "make it look good" requests with automatic quality improvements.

softaworks/meme-factory

Generate memes using the memegen.link API. Use when users request memes, want to add humor to content, or need visual aids for social media. Supports 100+ popular templates with custom text and styling.

softaworks/mermaid-diagrams

Comprehensive guide for creating software diagrams using Mermaid syntax. Use when users need to create, visualize, or document software through diagrams including class diagrams (domain modeling, object-oriented design), sequence diagrams (application flows, API interactions, code execution), flowcharts (processes, algorithms, user journeys), entity relationship diagrams (database schemas), C4 architecture diagrams (system context, containers, components), state diagrams, git graphs, pie charts, gantt charts, or any other diagram type. Triggers include requests to "diagram", "visualize", "model", "map out", "show the flow", or when explaining system architecture, database design, code structure, or user/application flows.

softaworks/naming-analyzer

Suggest better variable, function, and class names based on context and conventions.

相关技能