Notre avis
Automatise la recherche approfondie en répartissant les éléments d'un plan en tâches d'agents parallèles qui produisent des fichiers JSON validés selon un schéma.
Points forts
- L'exécution par lots parallèles accélère la recherche sur plusieurs sujets.
- La reprise automatique ignore les éléments déjà traités, évitant le travail redondant.
- La validation stricte du schéma garantit une couverture complète des champs.
- L'approbation utilisateur entre les lots offre un contrôle sur le déroulement.
Limites
- Nécessite un outline.yaml et un fields.yaml préexistants avec une structure exacte.
- Dépend d'un script de validation situé dans ~/.claude/skills/research/validate_json.py.
- Fonctionne uniquement dans l'environnement Claude Code.
Lorsque vous devez rechercher de nombreux sujets de manière structurée et répétable et collecter les résultats en JSON.
Lorsque vous avez besoin d'une réponse rapide à une question unique sans configurer un schéma et un plan.
Analyse de sécurité
PrudenceThe skill uses powerful tools (Bash, Task, WebSearch) for a legitimate research orchestration purpose. It does not directly instruct destructive or exfiltrating actions, but the execution of a Python script with user-controlled paths and the background agent launch warrant caution.
- •Uses Bash to execute a Python validation script, with variables derived from outline.yaml; potential shell command injection if those variables contain metacharacters, though the input is user-provided.
- •Launches background agents via Task and disables task output, which can reduce visibility into agent actions.
- •Relies on an external script (~/.claude/skills/research/validate_json.py) whose content is not specified; if replaced by a malicious script, execution could be harmful.
Exemples
/research-deepExecute the deep research workflow on the current outline, asking for approval before each batch.Continue the /research-deep run, skipping items already completed in the output directory.user-invocable: true description: Read research outline, launch independent agent for each item for deep research. Disable task output. allowed-tools: Bash, Read, Write, Glob, WebSearch, Task
Research Deep - Deep Research
Trigger
/research-deep
Workflow
Step 1: Auto-locate Outline
Find */outline.yaml file in current working directory, read items list, execution config (including items_per_agent).
Step 2: Resume Check
- Check completed JSON files in output_dir
- Skip completed items
Step 3: Batch Execution
- Batch by batch_size (need user approval before next batch)
- Each agent handles items_per_agent items
- Launch web-search-agent (background parallel, disable task output)
Parameter Retrieval:
{topic}: topic field from outline.yaml{item_name}: item's name field{item_related_info}: item's complete yaml content (name + category + description etc.){output_dir}: execution.output_dir from outline.yaml (default: ./results){fields_path}: absolute path to {topic}/fields.yaml{output_path}: absolute path to {output_dir}/{item_name_slug}.json (slugify item_name: replace spaces with _, remove special chars)
Hard Constraint: The following prompt must be strictly reproduced, only replacing variables in {xxx}, do not modify structure or wording.
Prompt Template:
prompt = f"""## Task
Research {item_related_info}, output structured JSON to {output_path}
## Field Definitions
Read {fields_path} to get all field definitions
## Output Requirements
1. Output JSON according to fields defined in fields.yaml
2. Mark uncertain field values with [uncertain]
3. Add uncertain array at the end of JSON, listing all uncertain field names
4. All field values must be in English
## Output Path
{output_path}
## Validation
After completing JSON output, run validation script to ensure complete field coverage:
python ~/.claude/skills/research/validate_json.py -f {fields_path} -j {output_path}
Task is complete only after validation passes.
"""
One-shot Example (assuming researching GitHub Copilot):
## Task
Research name: GitHub Copilot
category: International Product
description: Developed by Microsoft/GitHub, first mainstream AI coding assistant, ~40% market share, output structured JSON to /home/weizhena/AIcoding/aicoding-history/results/GitHub_Copilot.json
## Field Definitions
Read /home/weizhena/AIcoding/aicoding-history/fields.yaml to get all field definitions
## Output Requirements
1. Output JSON according to fields defined in fields.yaml
2. Mark uncertain field values with [uncertain]
3. Add uncertain array at the end of JSON, listing all uncertain field names
4. All field values must be in English
## Output Path
/home/weizhena/AIcoding/aicoding-history/results/GitHub_Copilot.json
## Validation
After completing JSON output, run validation script to ensure complete field coverage:
python ~/.claude/skills/research/validate_json.py -f /home/weizhena/AIcoding/aicoding-history/fields.yaml -j /home/weizhena/AIcoding/aicoding-history/results/GitHub_Copilot.json
Task is complete only after validation passes.
Step 4: Wait and Monitor
- Wait for current batch to complete
- Launch next batch
- Display progress
Step 5: Summary Report
After all complete, output:
- Completion count
- Failed/uncertain marked items
- Output directory
Agent Config
- Background execution: Yes
- Task Output: Disabled (agent has explicit output file when complete)
- Resume support: Yes
Ingénierie de Prompts
Data & IA
Bonnes pratiques et templates de prompt engineering pour maximiser les résultats IA.
Visualisation de Données
Data & IA
Génère des visualisations de données et graphiques adaptés à vos données.
Architecture RAG
Data & IA
Guide de configuration d'architectures RAG (Retrieval-Augmented Generation).