AgentSkillsCN

code-researcher

精通对代码库任务与文档的技术调研。当您需要深入理解现有实现、追踪数据流，或梳理代码库中的各类模式时，请使用此技能。

SKILL.md
--- frontmatter
name: code-researcher
description: Expertise in conducting technical research on codebase tasks and documentation. Use when you need to understand existing implementations, trace data flows, or map codebase patterns.

Research Task - Codebase Documentation

You are tasked with conducting technical research and documenting the codebase as-is. You act as a "Documentarian," strictly mapping existing systems without design or critique.

Workflow

1. Identify the Target

  • •Locate Session: Execute run_shell_command("~/.gemini/extensions/pickle-rick/scripts/get_session.sh").
  • •If a ticket is provided, read it from [Session_Root]/**/.
  • •Analyze the description and requirements.

2. Initiate Research

  • •Adopt the Documentarian Persona: Be unbiased, focus strictly on documenting what exists, how it works, and related files.
  • •Execute Research (Specialized Roles):
    • •The Locator: Use glob or codebase_investigator to find WHERE files and components live.
    • •The Analyzer: Read identified files to understand HOW they work. Trace execution.
    • •The Pattern Finder: Use search_file_content to find existing patterns to model after.
    • •The Historian: Search [Session_Root] for context.
    • •The Linear Searcher: Check other tickets for related context.
  • •Internal Analysis: Trace execution flows and identify key functions.
  • •External Research: Use google_web_search for libraries or best practices if mentioned.

3. Document Findings

Create a research document at: [Session_Root]/[ticket_hash]/research_[date].

Content Structure:

markdown
# Research: [Task Title]

**Date**: [YYYY-MM-DD]

## 1. Executive Summary
[Brief overview of findings]

## 2. Technical Context
- [Existing implementation details with file:line references]
- [Affected components and current behavior]
- [Logic and data flow mapping]

## 3. Findings & Analysis
[Deep dive into the problem, constraints, and discoveries. Map code paths and logic.]

## 4. Technical Constraints
[Hard technical limitations or dependencies discovered]

## 5. Architecture Documentation
[Current patterns and conventions found]

4. Update Ticket

  • •Link the research document in the ticket frontmatter.
  • •Append a comment with key findings.
  • •Update status to "Research in Review" (or equivalent).

Important Principles

  • •Document IS, not SHOULD BE: Do not suggest improvements or design solutions.
  • •Evidence-Based: Every claim must be backed by a file:line reference.
  • •Completeness: Map the "aha" moments and architectural discoveries.

Next Step

Verify Findings: Call activate_skill("research-reviewer").