deepspider 0.1.0

package/.trellis/spec/guides/index.md

@@ -0,0 +1,79 @@
+# Thinking Guides
+
+> **Purpose**: Expand your thinking to catch things you might not have considered.
+
+---
+
+## Why Thinking Guides?
+
+**Most bugs and tech debt come from "didn't think of that"**, not from lack of skill:
+
+- Didn't think about what happens at layer boundaries → cross-layer bugs
+- Didn't think about code patterns repeating → duplicated code everywhere
+- Didn't think about edge cases → runtime errors
+- Didn't think about future maintainers → unreadable code
+
+These guides help you **ask the right questions before coding**.
+
+---
+
+## Available Guides
+
+| Guide | Purpose | When to Use |
+|-------|---------|-------------|
+| [Code Reuse Thinking Guide](./code-reuse-thinking-guide.md) | Identify patterns and reduce duplication | When you notice repeated patterns |
+| [Cross-Layer Thinking Guide](./cross-layer-thinking-guide.md) | Think through data flow across layers | Features spanning multiple layers |
+
+---
+
+## Quick Reference: Thinking Triggers
+
+### When to Think About Cross-Layer Issues
+
+- [ ] Feature touches 3+ layers (API, Service, Component, Database)
+- [ ] Data format changes between layers
+- [ ] Multiple consumers need the same data
+- [ ] You're not sure where to put some logic
+
+→ Read [Cross-Layer Thinking Guide](./cross-layer-thinking-guide.md)
+
+### When to Think About Code Reuse
+
+- [ ] You're writing similar code to something that exists
+- [ ] You see the same pattern repeated 3+ times
+- [ ] You're adding a new field to multiple places
+- [ ] **You're modifying any constant or config**
+- [ ] **You're creating a new utility/helper function** ← Search first!
+
+→ Read [Code Reuse Thinking Guide](./code-reuse-thinking-guide.md)
+
+---
+
+## Pre-Modification Rule (CRITICAL)
+
+> **Before changing ANY value, ALWAYS search first!**
+
+```bash
+# Search for the value you're about to change
+grep -r "value_to_change" .
+```
+
+This single habit prevents most "forgot to update X" bugs.
+
+---
+
+## How to Use This Directory
+
+1. **Before coding**: Skim the relevant thinking guide
+2. **During coding**: If something feels repetitive or complex, check the guides
+3. **After bugs**: Add new insights to the relevant guide (learn from mistakes)
+
+---
+
+## Contributing
+
+Found a new "didn't think of that" moment? Add it to the relevant guide.
+
+---
+
+**Core Principle**: 30 minutes of thinking saves 3 hours of debugging.

package/.trellis/tasks/archive/02-02-evolving-skills/prd.md

@@ -0,0 +1,61 @@
+# Self-Evolving Skills System
+
+## 目标
+
+实现 Skills 自我进化机制，让 Agent 在分析过程中积累的经验能够持久化，系统越用越好用。
+
+## 核心设计
+
+### 目录结构
+
+```
+src/agent/skills/<skill-name>/
+├── SKILL.md      # 静态：基础知识（git管理）
+└── evolved.md    # 动态：运行时积累
+```
+
+### evolved.md 格式
+
+```markdown
+---
+total: 15
+last_merged: 2026-01-15
+---
+
+## 核心经验
+
+### 经验标题
+**场景**: 具体案例
+**经验**: 一句话总结
+
+## 近期发现
+
+### [2026-02-02] 发现标题
+**场景**: 具体案例
+**经验**: 一句话总结
+```
+
+### 加载策略
+
+- 静态 SKILL.md：全量加载
+- 动态 evolved.md：核心经验 + 最近 10 条
+
+### 阈值提示
+
+- 动态经验达到 20 条时提示合并
+- 合并通过命令触发：`/evolve:merge <skill-name>`
+
+## 实现清单
+
+1. [ ] 创建 `evolved.md` 模板文件
+2. [ ] 实现 `createEvolvingSkillsMiddleware` 中间件
+3. [ ] 实现 `evolve_skill` 工具
+4. [ ] 创建 `/evolve:merge` 命令
+5. [ ] 更新各 subagent 使用新中间件
+6. [ ] 更新 systemPrompt 指导 Agent 何时进化
+
+## 技术要点
+
+- 中间件在 Agent 启动时合并静态+动态
+- evolve_skill 工具追加内容到 evolved.md
+- 合并命令将核心经验迁移到 SKILL.md

package/.trellis/tasks/archive/02-02-evolving-skills/task.json

@@ -0,0 +1,29 @@
+{
+  "id": "evolving-skills",
+  "name": "evolving-skills",
+  "title": "Self-Evolving Skills System",
+  "description": "",
+  "status": "planning",
+  "dev_type": null,
+  "scope": null,
+  "priority": "P2",
+  "creator": "pony",
+  "assignee": "pony",
+  "createdAt": "2026-02-02",
+  "completedAt": null,
+  "branch": null,
+  "base_branch": null,
+  "worktree_path": null,
+  "current_phase": 0,
+  "next_action": [
+    {"phase": 1, "action": "implement"},
+    {"phase": 2, "action": "check"},
+    {"phase": 3, "action": "finish"},
+    {"phase": 4, "action": "create-pr"}
+  ],
+  "commit": null,
+  "pr_url": null,
+  "subtasks": [],
+  "relatedFiles": [],
+  "notes": ""
+}

package/.trellis/tasks/archive/2026-02/00-bootstrap-guidelines/prd.md

@@ -0,0 +1,86 @@
+# Bootstrap: Fill Project Development Guidelines
+
+## Purpose
+
+Welcome to Trellis! This is your first task.
+
+AI agents use `.trellis/spec/` to understand YOUR project's coding conventions.
+**Empty templates = AI writes generic code that doesn't match your project style.**
+
+Filling these guidelines is a one-time setup that pays off for every future AI session.
+
+---
+
+## Your Task
+
+Fill in the guideline files based on your **existing codebase**.
+
+### Frontend Guidelines
+
+| File | What to Document |
+|------|------------------|
+| `.trellis/spec/frontend/directory-structure.md` | Component/page/hook organization |
+| `.trellis/spec/frontend/component-guidelines.md` | Component patterns, props conventions |
+| `.trellis/spec/frontend/hook-guidelines.md` | Custom hook naming, patterns |
+| `.trellis/spec/frontend/state-management.md` | State library, patterns, what goes where |
+| `.trellis/spec/frontend/type-safety.md` | TypeScript conventions, type organization |
+| `.trellis/spec/frontend/quality-guidelines.md` | Linting, testing, accessibility |
+
+### Thinking Guides (Optional)
+
+The `.trellis/spec/guides/` directory contains thinking guides that are already
+filled with general best practices. You can customize them for your project if needed.
+
+---
+
+## How to Fill Guidelines
+
+### Principle: Document Reality, Not Ideals
+
+Write what your codebase **actually does**, not what you wish it did.
+AI needs to match existing patterns, not introduce new ones.
+
+### Steps
+
+1. **Look at existing code** - Find 2-3 examples of each pattern
+2. **Document the pattern** - Describe what you see
+3. **Include file paths** - Reference real files as examples
+4. **List anti-patterns** - What does your team avoid?
+
+---
+
+## Tips for Using AI
+
+Ask AI to help analyze your codebase:
+
+- "Look at my codebase and document the patterns you see"
+- "Analyze my code structure and summarize the conventions"
+- "Find error handling patterns and document them"
+
+The AI will read your code and help you document it.
+
+---
+
+## Completion Checklist
+
+- [ ] Guidelines filled for your project type
+- [ ] At least 2-3 real code examples in each guideline
+- [ ] Anti-patterns documented
+
+When done:
+
+```bash
+./.trellis/scripts/task.sh finish
+./.trellis/scripts/task.sh archive 00-bootstrap-guidelines
+```
+
+---
+
+## Why This Matters
+
+After completing this task:
+
+1. AI will write code that matches your project style
+2. Relevant `/trellis:before-*-dev` commands will inject real context
+3. `/trellis:check-*` commands will validate against your actual standards
+4. Future developers (human or AI) will onboard faster

package/.trellis/tasks/archive/2026-02/00-bootstrap-guidelines/task.json

@@ -0,0 +1,27 @@
+{
+  "id": "00-bootstrap-guidelines",
+  "name": "Bootstrap Guidelines",
+  "description": "Fill in project development guidelines for AI agents",
+  "status": "completed",
+  "dev_type": "docs",
+  "priority": "P1",
+  "creator": "pony",
+  "assignee": "pony",
+  "createdAt": "2026-01-30",
+  "completedAt": "2026-02-02",
+  "commit": null,
+  "subtasks": [
+    {
+      "name": "Fill frontend guidelines",
+      "status": "pending"
+    },
+    {
+      "name": "Add code examples",
+      "status": "pending"
+    }
+  ],
+  "relatedFiles": [
+    ".trellis/spec/frontend/"
+  ],
+  "notes": "First-time setup task created by trellis init (frontend project)"
+}

package/.trellis/tasks/archive/2026-02/02-02-skills-system/check.jsonl

@@ -0,0 +1,3 @@
+{"file": ".claude/commands/trellis/finish-work.md", "reason": "Finish work checklist"}
+{"file": ".trellis/spec/shared/index.md", "reason": "Shared coding standards"}
+{"file": ".claude/commands/trellis/check-backend.md", "reason": "Backend check spec"}

package/.trellis/tasks/archive/2026-02/02-02-skills-system/debug.jsonl

@@ -0,0 +1,2 @@
+{"file": ".trellis/spec/shared/index.md", "reason": "Shared coding standards"}
+{"file": ".claude/commands/trellis/check-backend.md", "reason": "Backend check spec"}

package/.trellis/tasks/archive/2026-02/02-02-skills-system/implement.jsonl

@@ -0,0 +1,5 @@
+{"file": ".trellis/workflow.md", "reason": "Project workflow and conventions"}
+{"file": ".trellis/spec/shared/index.md", "reason": "Shared coding standards"}
+{"file": ".trellis/spec/backend/index.md", "reason": "Backend development guide"}
+{"file": ".trellis/spec/backend/api-module.md", "reason": "API module conventions"}
+{"file": ".trellis/spec/backend/quality.md", "reason": "Code quality requirements"}

package/.trellis/tasks/archive/2026-02/02-02-skills-system/prd.md

@@ -0,0 +1,33 @@
+# Implement Skills System with Progressive Disclosure
+
+## Goal
+
+实现 Skills 系统，支持主 agent 和子 agent 按需加载工具，实现渐进式披露。
+
+## Requirements
+
+### 1. Skills 定义
+- 每个 skill 包含：name, description, tools, systemPrompt (可选)
+- Skills 按功能分组（静态分析、动态分析、沙箱执行等）
+
+### 2. 渐进式披露
+- 主 agent 默认只加载核心工具
+- 提供 `use_skill` 工具激活特定 skill
+- 激活后，skill 的工具可用于当前会话
+
+### 3. 使用 deepagents middleware
+- 通过 middleware 实现 skill 管理
+- 子 agent 可以预绑定特定 skills
+
+## Acceptance Criteria
+
+- [ ] Skills 目录结构创建
+- [ ] SkillsMiddleware 实现
+- [ ] 主 agent 集成 skills middleware
+- [ ] 子 agent 支持预绑定 skills
+- [ ] use_skill 工具可正常激活 skill
+
+## Technical Notes
+
+- 使用 deepagents 的 AgentMiddleware 接口
+- 参考现有 middleware 实现模式

package/.trellis/tasks/archive/2026-02/02-02-skills-system/task.json

@@ -0,0 +1,41 @@
+{
+  "id": "skills-system",
+  "name": "skills-system",
+  "title": "Implement Skills System with Progressive Disclosure",
+  "description": "",
+  "status": "completed",
+  "dev_type": null,
+  "scope": null,
+  "priority": "P2",
+  "creator": "pony",
+  "assignee": "pony",
+  "createdAt": "2026-02-02",
+  "completedAt": "2026-02-02",
+  "branch": null,
+  "base_branch": null,
+  "worktree_path": null,
+  "current_phase": 0,
+  "next_action": [
+    {
+      "phase": 1,
+      "action": "implement"
+    },
+    {
+      "phase": 2,
+      "action": "check"
+    },
+    {
+      "phase": 3,
+      "action": "finish"
+    },
+    {
+      "phase": 4,
+      "action": "create-pr"
+    }
+  ],
+  "commit": null,
+  "pr_url": null,
+  "subtasks": [],
+  "relatedFiles": [],
+  "notes": ""
+}