trellis-analyze-task

Analyzes existing Trellis tasks and refines prd.md and task.json through interactive clarification.

Updated Jun 8, 2026
One-click install
npx skills add https://github.com/SilentFlower/flower-trellis --skill trellis-analyze-task-silentflower
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: trellis-analyze-task
Source: https://github.com/SilentFlower/flower-trellis/tree/main/enhancements/0.5/.agents/skills/trellis-analyze-task
Command: npx skills add https://github.com/SilentFlower/flower-trellis --skill trellis-analyze-task-silentflower

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Existing tasks in .trellis/tasks/ often lack clear scope, defined risks, or unambiguous requirements, making them hard to implement. This Skill reads task.json and prd.md, scans related code, and produces a structured analysis report before refining the task through one-at-a-time clarifying questions. ## Core Features & Use Cases - Task Analysis Report: Generates an overview, work preview, affected modules, risks, and ambiguities for any task under .trellis/tasks/. - Interactive Refinement: Asks clarifying questions one at a time with concrete options, then immediately updates prd.md and task.json after each answer. - Context Collection: Silently gathers task files, related code structure, dependent tasks, and journal history before analyzing. - Use Case: You have a vaguely defined task like "add caching" and need to understand its impact surface, risks, and open questions before starting development. ## Quick Start Ask the AI to analyze and refine an existing Trellis task by saying "分析任务" or "细化任务" and optionally providing the task slug.

Frequently Asked Questions about trellis-analyze-task

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I analyze an existing Trellis task before development?▼

Invoke the skill with a task slug or let it list active tasks via the task.py list command. It reads task.json and prd.md, scans related code, and outputs a report covering scope, risks, and ambiguities.

What is the difference between trellis-analyze-task and trellis-brainstorm?▼

trellis-brainstorm starts from a vague idea with no task yet and discovers requirements. trellis-analyze-task works on an already-created task under .trellis/tasks/ to deepen analysis and refine its prd.md and task.json.

Does the skill update task files automatically?▼

Yes. After each clarifying answer, it immediately updates prd.md (creating it if missing) and adjusts relevant task.json fields such as priority or description, then proceeds to the next open question.

When should I use trellis-continue instead of task analysis?▼

Use trellis-continue when the task already has a sufficiently detailed prd.md and you want to enter or resume the development flow. Use analysis first when requirements, risks, or impact are still unclear.

What context does the task analysis collect before reporting?▼

It silently gathers the task.json and prd.md files, scans related code modules, checks for dependent or related tasks, and reviews journal history for prior records about the task.