specs-explore

specs-explore 技能

调查代码库、深入分析问题、比较不同方案，并返回结构化分析。仅在提供 --spec 时创建 exploration.md。

你会收到什么

协调器会提供：

• 要探索的主题或功能
• --spec 路径（可选）
• --lang 框架（可选）

执行步骤

步骤 1：理解请求

解析用户想探索的内容：

• 这是新功能、错误修复还是重构？
• 涉及哪个领域？

步骤 2：调查代码库

阅读相关代码，了解：

• 当前架构和模式
• 可能受影响的文件和模块
• 与请求相关的现有行为
• 潜在约束或风险

INVESTIGATE:
├── Read entry points and key files
├── Search for related functionality (Grep)
├── Check existing tests (Glob)
├── Look for patterns already in use
└── Identify dependencies and coupling

步骤 3：分析方案

如果有多种方案，请进行比较：

方案	优点	缺点	复杂度
方案 A	...	...	低/中/高
方案 B	...	...	低/中/高

步骤 4：保存产物（如果提供了 --spec）

如果指定了 --spec=docs/specs/001-add-jwt-auth，请写入 docs/specs/001-add-jwt-auth/exploration.md：

## Exploration: {topic}

### Current State
{How the system works today relevant to this topic}

### Affected Areas
- `path/to/file.ext` — {why it's affected}
- `path/to/other.ext` — {why it's affected}

### Approaches
1. **{Approach name}** — {brief description}
   - Pros: {list}
   - Cons: {list}
   - Effort: {Low/Medium/High}

2. **{Approach name}** — {brief description}
   - Pros: {list}
   - Cons: {list}
   - Effort: {Low/Medium/High}

### Recommendation
{Your recommended approach and why}

### Risks
- {Risk 1}
- {Risk 2}

### Ready for Proposal
{Yes/No — and what the user should know}

步骤 5：返回结果

返回相同的结构化分析（内联），并附上：

状态报告：

• 状态：done | blocked | partial
• 执行摘要：用 1 句话描述探索内容和关键建议
• 产物：{spec}/exploration.md（如果提供了 --spec），否则为 "none"
• 下一步建议：specs.brainstorm（如果提供了 spec），否则为 none（如果独立运行）
• 风险：发现的风险，或 "None"

---

规则

• 唯一允许创建的文件是 spec 文件夹中的 exploration.md（如果提供了 --spec）
• 不要修改任何现有代码或文件
• 始终阅读真实代码，切勿对代码库情况妄加推测
• 分析应简洁——总结即可，不要长篇大论
• 如果找不到足够的信息，请明确说明
• 如果请求过于含糊，请寻求澄清