deepspider 0.2.11 → 0.3.0

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

@@ -1,33 +0,0 @@
-# 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

@@ -1,41 +0,0 @@
-{
-  "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": ""
-}

package/.trellis/workflow.md

@@ -1,407 +0,0 @@
-# Development Workflow
-
-> Based on [Effective Harnesses for Long-Running Agents](https://www.anthropic.com/engineering/effective-harnesses-for-long-running-agents)
-
----
-
-## Table of Contents
-
-1. [Quick Start (Do This First)](#quick-start-do-this-first)
-2. [Workflow Overview](#workflow-overview)
-3. [Session Start Process](#session-start-process)
-4. [Development Process](#development-process)
-5. [Session End](#session-end)
-6. [File Descriptions](#file-descriptions)
-7. [Best Practices](#best-practices)
-
----
-
-## Quick Start (Do This First)
-
-### Step 0: Initialize Developer Identity (First Time Only)
-
-> **Multi-developer support**: Each developer/Agent needs to initialize their identity first
-
-```bash
-# Check if already initialized
-./.trellis/scripts/get-developer.sh
-
-# If not initialized, run:
-./.trellis/scripts/init-developer.sh <your-name>
-# Example: ./.trellis/scripts/init-developer.sh cursor-agent
-```
-
-This creates:
-- `.trellis/.developer` - Your identity file (gitignored, not committed)
-- `.trellis/workspace/<your-name>/` - Your personal workspace directory
-
-**Naming suggestions**:
-- Human developers: Use your name, e.g., `john-doe`
-- Cursor AI: `cursor-agent` or `cursor-<task>`
-- Claude Code: `claude-agent` or `claude-<task>`
-
-### Step 1: Understand Current Context
-
-```bash
-# Get full context in one command
-./.trellis/scripts/get-context.sh
-
-# Or check manually:
-./.trellis/scripts/get-developer.sh      # Your identity
-./.trellis/scripts/task.sh list          # Active tasks
-git status && git log --oneline -10      # Git state
-```
-
-### Step 2: Read Project Guidelines [MANDATORY]
-
-**CRITICAL**: Read guidelines before writing any code:
-
-```bash
-# Read frontend guidelines index (if applicable)
-cat .trellis/spec/frontend/index.md
-
-# Read backend guidelines index (if applicable)
-cat .trellis/spec/backend/index.md
-```
-
-**Why read both?**
-- Understand the full project architecture
-- Know coding standards for the entire codebase
-- See how frontend and backend interact
-- Learn the overall code quality requirements
-
-### Step 3: Before Coding - Read Specific Guidelines (Required)
-
-Based on your task, read the **detailed** guidelines:
-
-**Frontend Task**:
-```bash
-cat .trellis/spec/frontend/hook-guidelines.md      # For hooks
-cat .trellis/spec/frontend/component-guidelines.md # For components
-cat .trellis/spec/frontend/type-safety.md          # For types
-```
-
-**Backend Task**:
-```bash
-cat .trellis/spec/backend/database-guidelines.md   # For DB operations
-cat .trellis/spec/backend/type-safety.md           # For types
-cat .trellis/spec/backend/logging-guidelines.md    # For logging
-```
-
----
-
-## Workflow Overview
-
-### Core Principles
-
-1. **Read Before Write** - Understand context before starting
-2. **Follow Standards** - [!] **MUST read `.trellis/spec/` guidelines before coding**
-3. **Incremental Development** - Complete one task at a time
-4. **Record Promptly** - Update tracking files immediately after completion
-5. **Document Limits** - [!] **Max 2000 lines per journal document**
-
-### File System
-
-```
-.trellis/
-|-- .developer           # Developer identity (gitignored)
-|-- scripts/
-|   |-- common/              # Shared utilities
-|   |   |-- paths.sh         # Path utilities
-|   |   |-- developer.sh     # Developer management
-|   |   \-- git-context.sh   # Git context implementation
-|   |-- init-developer.sh    # Initialize developer identity
-|   |-- get-developer.sh     # Get current developer name
-|   |-- task.sh              # Manage tasks
-|   |-- get-context.sh       # Get session context
-|   \-- add-session.sh       # One-click session recording
-|-- workspace/           # Developer workspaces
-|   |-- index.md         # Workspace index + Session template
-|   \-- {developer}/     # Per-developer directories
-|       |-- index.md     # Personal index (with @@@auto markers)
-|       \-- journal-N.md # Journal files (sequential numbering)
-|-- tasks/               # Task tracking
-|   \-- {MM}-{DD}-{name}/
-|       \-- task.json
-|-- spec/                # [!] MUST READ before coding
-|   |-- frontend/        # Frontend guidelines (if applicable)
-|   |   |-- index.md               # Start here - guidelines index
-|   |   \-- *.md                   # Topic-specific docs
-|   |-- backend/         # Backend guidelines (if applicable)
-|   |   |-- index.md               # Start here - guidelines index
-|   |   \-- *.md                   # Topic-specific docs
-|   \-- guides/          # Thinking guides
-|       |-- index.md                      # Guides index
-|       |-- cross-layer-thinking-guide.md # Pre-implementation checklist
-|       \-- *.md                          # Other guides
-\-- workflow.md             # This document
-```
-
----
-
-## Session Start Process
-
-### Step 1: Get Session Context
-
-Use the unified context script:
-
-```bash
-# Get all context in one command
-./.trellis/scripts/get-context.sh
-
-# Or get JSON format
-./.trellis/scripts/get-context.sh --json
-```
-
-### Step 2: Read Development Guidelines [!] REQUIRED
-
-**[!] CRITICAL: MUST read guidelines before writing any code**
-
-Based on what you'll develop, read the corresponding guidelines:
-
-**Frontend Development** (if applicable):
-```bash
-# Read index first, then specific docs based on task
-cat .trellis/spec/frontend/index.md
-```
-
-**Backend Development** (if applicable):
-```bash
-# Read index first, then specific docs based on task
-cat .trellis/spec/backend/index.md
-```
-
-**Cross-Layer Features**:
-```bash
-# For features spanning multiple layers
-cat .trellis/spec/guides/cross-layer-thinking-guide.md
-```
-
-### Step 3: Select Task to Develop
-
-Use the task management script:
-
-```bash
-# List active tasks
-./.trellis/scripts/task.sh list
-
-# Create new task (creates directory with task.json)
-./.trellis/scripts/task.sh create "<title>" --slug <task-name>
-```
-
----
-
-## Development Process
-
-### Task Development Flow
-
-```
-1. Create or select task
-   \-> ./.trellis/scripts/task.sh create "<title>" --slug <name> or list
-
-2. Write code according to guidelines
-   \-> Read .trellis/spec/ docs relevant to your task
-   \-> For cross-layer: read .trellis/spec/guides/
-
-3. Self-test
-   \-> Run project's lint/test commands (see spec docs)
-   \-> Manual feature testing
-
-4. Commit code
-   \-> git add <files>
-   \-> git commit -m "type(scope): description"
-       Format: feat/fix/docs/refactor/test/chore
-
-5. Record session (one command)
-   \-> ./.trellis/scripts/add-session.sh --title "Title" --commit "hash"
-```
-
-### Code Quality Checklist
-
-**Must pass before commit**:
-- [OK] Lint checks pass (project-specific command)
-- [OK] Type checks pass (if applicable)
-- [OK] Manual feature testing passes
-
-**Project-specific checks**:
-- See `.trellis/spec/frontend/quality-guidelines.md` for frontend
-- See `.trellis/spec/backend/quality-guidelines.md` for backend
-
----
-
-## Session End
-
-### One-Click Session Recording
-
-After code is committed, use:
-
-```bash
-./.trellis/scripts/add-session.sh \
-  --title "Session Title" \
-  --commit "abc1234" \
-  --summary "Brief summary"
-```
-
-This automatically:
-1. Detects current journal file
-2. Creates new file if 2000-line limit exceeded
-3. Appends session content
-4. Updates index.md (sessions count, history table)
-
-### Pre-end Checklist
-
-Use `/trellis:finish-work` command to run through:
-1. [OK] All code committed, commit message follows convention
-2. [OK] Session recorded via `add-session.sh`
-3. [OK] No lint/test errors
-4. [OK] Working directory clean (or WIP noted)
-5. [OK] Spec docs updated if needed
-
----
-
-## File Descriptions
-
-### 1. workspace/ - Developer Workspaces
-
-**Purpose**: Record each AI Agent session's work content
-
-**Structure** (Multi-developer support):
-```
-workspace/
-|-- index.md              # Main index (Active Developers table)
-\-- {developer}/          # Per-developer directory
-    |-- index.md          # Personal index (with @@@auto markers)
-    \-- journal-N.md      # Journal files (sequential: 1, 2, 3...)
-```
-
-**When to update**:
-- [OK] End of each session
-- [OK] Complete important task
-- [OK] Fix important bug
-
-### 2. spec/ - Development Guidelines
-
-**Purpose**: Documented standards for consistent development
-
-**Structure** (Multi-doc format):
-```
-spec/
-|-- frontend/           # Frontend docs (if applicable)
-|   |-- index.md        # Start here
-|   \-- *.md            # Topic-specific docs
-|-- backend/            # Backend docs (if applicable)
-|   |-- index.md        # Start here
-|   \-- *.md            # Topic-specific docs
-\-- guides/             # Thinking guides
-    |-- index.md        # Start here
-    \-- *.md            # Guide-specific docs
-```
-
-**When to update**:
-- [OK] New pattern discovered
-- [OK] Bug fixed that reveals missing guidance
-- [OK] New convention established
-
-### 3. Tasks - Task Tracking
-
-Each task is a directory containing `task.json`:
-
-```
-tasks/
-|-- 01-21-my-task/
-|   \-- task.json
-\-- archive/
-    \-- 2026-01/
-        \-- 01-15-old-task/
-            \-- task.json
-```
-
-**Commands**:
-```bash
-./.trellis/scripts/task.sh create "<title>" [--slug <name>]   # Create task directory
-./.trellis/scripts/task.sh archive <name>  # Archive to archive/{year-month}/
-./.trellis/scripts/task.sh list            # List active tasks
-./.trellis/scripts/task.sh list-archive    # List archived tasks
-```
-
----
-
-## Best Practices
-
-### [OK] DO - Should Do
-
-1. **Before session start**:
-   - Run `./.trellis/scripts/get-context.sh` for full context
-   - [!] **MUST read** relevant `.trellis/spec/` docs
-
-2. **During development**:
-   - [!] **Follow** `.trellis/spec/` guidelines
-   - For cross-layer features, use `/trellis:check-cross-layer`
-   - Develop only one task at a time
-   - Run lint and tests frequently
-
-3. **After development complete**:
-   - Use `/trellis:finish-work` for completion checklist
-   - After fix bug, use `/trellis:break-loop` for deep analysis
-   - Human commits after testing passes
-   - Use `add-session.sh` to record progress
-
-### [X] DON'T - Should Not Do
-
-1. [!] **Don't** skip reading `.trellis/spec/` guidelines
-2. [!] **Don't** let journal single file exceed 2000 lines
-3. **Don't** develop multiple unrelated tasks simultaneously
-4. **Don't** commit code with lint/test errors
-5. **Don't** forget to update spec docs after learning something
-6. [!] **Don't** execute `git commit` - AI should not commit code
-
----
-
-## Quick Reference
-
-### Must-read Before Development
-
-| Task Type | Must-read Document |
-|-----------|-------------------|
-| Frontend work | `frontend/index.md` → relevant docs |
-| Backend work | `backend/index.md` → relevant docs |
-| Cross-Layer Feature | `guides/cross-layer-thinking-guide.md` |
-
-### Commit Convention
-
-```bash
-git commit -m "type(scope): description"
-```
-
-**Type**: feat, fix, docs, refactor, test, chore
-**Scope**: Module name (e.g., auth, api, ui)
-
-### Common Commands
-
-```bash
-# Session management
-./.trellis/scripts/get-context.sh    # Get full context
-./.trellis/scripts/add-session.sh    # Record session
-
-# Task management
-./.trellis/scripts/task.sh list      # List tasks
-./.trellis/scripts/task.sh create "<title>" # Create task
-
-# Slash commands
-/trellis:finish-work          # Pre-commit checklist
-/trellis:break-loop           # Post-debug analysis
-/trellis:check-cross-layer    # Cross-layer verification
-```
-
----
-
-## Summary
-
-Following this workflow ensures:
-- [OK] Continuity across multiple sessions
-- [OK] Consistent code quality
-- [OK] Trackable progress
-- [OK] Knowledge accumulation in spec docs
-- [OK] Transparent team collaboration
-
-**Core Philosophy**: Read before write, follow standards, record promptly, capture learnings

package/.trellis/workspace/index.md

@@ -1,123 +0,0 @@
-# Workspace Index
-
-> Records of all AI Agent work records across all developers
-
----
-
-## Overview
-
-This directory tracks records for all developers working with AI Agents on this project.
-
-### File Structure
-
-```
-workspace/
-|-- index.md              # This file - main index
-\-- {developer}/          # Per-developer directory
-    |-- index.md          # Personal index with session history
-    |-- tasks/         # Task files
-    |   |-- *.json        # Active tasks
-    |   \-- archive/      # Archived tasks by month
-    \-- journal-N.md     # Journal files (sequential: 1, 2, 3...)
-```
-
----
-
-## Active Developers
-
-| Developer | Last Active | Sessions | Active File |
-|-----------|-------------|----------|-------------|
-| (none yet) | - | - | - |
-
----
-
-## Getting Started
-
-### For New Developers
-
-Run the initialization script:
-
-```bash
-./.trellis/scripts/init-developer.sh <your-name>
-```
-
-This will:
-1. Create your identity file (gitignored)
-2. Create your progress directory
-3. Create your personal index
-4. Create initial journal file
-
-### For Returning Developers
-
-1. Get your developer name:
-   ```bash
-   ./.trellis/scripts/get-developer.sh
-   ```
-
-2. Read your personal index:
-   ```bash
-   cat .trellis/workspace/$(./.trellis/scripts/get-developer.sh)/index.md
-   ```
-
----
-
-## Guidelines
-
-### Journal File Rules
-
-- **Max 2000 lines** per journal file
-- When limit is reached, create `journal-{N+1}.md`
-- Update your personal `index.md` when creating new files
-
-### Session Record Format
-
-Each session should include:
-- Summary: One-line description
-- Main Changes: What was modified
-- Git Commits: Commit hashes and messages
-- Next Steps: What to do next
-
----
-
-## Session Template
-
-Use this template when recording sessions:
-
-```markdown
-## Session {N}: {Title}
-
-**Date**: YYYY-MM-DD
-**Task**: {task-name}
-
-### Summary
-
-{One-line summary}
-
-### Main Changes
-
-- {Change 1}
-- {Change 2}
-
-### Git Commits
-
-| Hash | Message |
-|------|---------|
-| `abc1234` | {commit message} |
-
-### Testing
-
-- [OK] {Test result}
-
-### Status
-
-[OK] **Completed** / # **In Progress** / [P] **Blocked**
-
-### Next Steps
-
-- {Next step 1}
-- {Next step 2}
-```
-
----
-
-**Language**: All documentation must be written in **English**.

package/.trellis/workspace/pony/index.md

@@ -1,42 +0,0 @@
-# Workspace Index - pony
-
-> Journal tracking for AI development sessions.
-
----
-
-## Current Status
-
-<!-- @@@auto:current-status -->
-- **Active File**: `journal-1.md`
-- **Total Sessions**: 2
-- **Last Active**: 2026-02-03
-<!-- @@@/auto:current-status -->
-
----
-
-## Active Documents
-
-<!-- @@@auto:active-documents -->
-| File | Lines | Status |
-|------|-------|--------|
-| `journal-1.md` | ~125 | Active |
-<!-- @@@/auto:active-documents -->
-
----
-
-## Session History
-
-<!-- @@@auto:session-history -->
-| # | Date | Title | Commits |
-|---|------|-------|---------|
-| 2 | 2026-02-03 | GitHub Actions 自动发布 npm | `4ff9a25`, `debdc4e`, `ab56fe2`, `67f9c55`, `b13b03d`, `63a6304`, `327ca39`, `78de837`, `46ce73e` |
-| 1 | 2026-02-03 | 环境变量重命名与配置检测 | `4aa6cad` |
-<!-- @@@/auto:session-history -->
-
----
-
-## Notes
-
-- Sessions are appended to journal files
-- New journal file created when current exceeds 2000 lines
-- Use `add-session.sh` to record sessions