innate-wip

**Innate** is a personal website and project tracking platform. It aggregates GitHub Issues, project documentation, and generates weekly progress summaries with AI analysis.

项目优势

暂无记录

改进空间

暂无记录

主要功能

暂无记录

AI Agent Context

This file provides context for AI assistants working with this codebase.

Project Overview

Innate is a personal website and project tracking platform. It aggregates GitHub Issues, project documentation, and generates weekly progress summaries with AI analysis.

What this website does:

Displays GitHub Issues from multiple repositories in a unified interface
Shows Project Documentation (AGENTS.md) with markdown rendering
Tracks Weekly Progress with AI-generated summaries and evaluations
Provides a Knowledge Base for tutorials and learning resources
Cheatsheets - 300+ quick reference guides for developer tools and frameworks
Collections - Ideas and experiments from AI agents
Writing - Blog platform with RSS feed support

Data Sources:

GitHub API - Fetches issues, projects, and metadata
AGENTS.md files - Project documentation from repositories
Weekly Data - Generated summaries stored in JSON files

Architecture

Monorepo Structure

innate-websites/
├── apps/
│   └── web/                    # Main Next.js application
│       ├── app/making/         # Core features
│       │   ├── issues/         # GitHub issues browser
│       │   ├── projects/       # Project showcase
│       │   └── weekly/         # Weekly summaries
│       ├── app/cheatsheets/    # Quick reference guides
│       ├── app/collections/    # AI agent collections
│       ├── app/writing/        # Blog posts
│       ├── app/tutorials/      # Quick tutorials
│       ├── app/feed/           # Content discovery feed
│       ├── data/               # JSON data files
│       │   ├── issues.json     # GitHub issues data
│       │   ├── projects.json   # Project analysis
│       │   └── weekly.json     # Weekly summaries
│       ├── components/         # React components
│       │   ├── making/         # Feature-specific components
│       │   ├── cheatsheets/    # Cheatsheet components
│       │   ├── collections/    # Collection components
│       │   ├── markdown-renderer.tsx
│       │   └── server-markdown.tsx
│       ├── lib/making/         # Data layer
│       │   ├── data.ts         # Static data imports
│       │   ├── types.ts        # TypeScript types
│       │   └── server-data.ts  # Server-side data loading
│       ├── lib/cheatsheets/    # Cheatsheet data layer
│       │   ├── data.ts         # Markdown file parsing
│       │   └── types.ts        # Cheatsheet types
│       └── scripts/            # Data fetching scripts
│           ├── fetch-issues.js
│           ├── fetch-agents.js
│           └── generate-weekly.js
├── packages/
│   ├── ui/                     # Shared UI component library
│   ├── utils/                  # Shared utility functions
│   └── tsconfig/               # Shared TypeScript configs
└── .github/workflows/          # CI/CD workflows

Key Technologies

React 19 with Next.js 16
TypeScript 6
pnpm workspaces
Tailwind CSS for styling
Radix UI for accessible components
unified/remark for markdown processing

Important Patterns

Data Flow

Static Data - JSON files are imported directly for static export
Build-time Rendering - ServerMarkdown component renders markdown at build time
Client Hydration - Interactive components use client-side rendering

Markdown Rendering

Two approaches are used:

ServerMarkdown (components/server-markdown.tsx)
- Server component that renders markdown to HTML at build time
- Used for issue descriptions and project documentation
- Applies custom CSS styles via markdown-content class
MarkdownRenderer (components/markdown-renderer.tsx)
- Client component for dynamic content
- Supports mermaid diagrams (if available)

Data Types

Issue

interface Issue {
  id: string
  number: number
  title: string
  description: string  // Markdown content
  status: 'open' | 'closed'
  project: string
  labels: IssueLabel[]
  createdAt: string
  updatedAt: string
  closedAt?: string
  url?: string
  author?: string
}

Project Analysis

interface ProjectAnalysis {
  id: string
  name: string
  description?: string
  hasAgents: boolean
  summary: string
  features: string[]
  strengths: string[]
  weaknesses: string[]
  rawContent?: string  // AGENTS.md content
}

Weekly Summary

interface WeeklySummary {
  id: string
  weekNumber: number
  year: number
  title: string
  titleZh?: string
  dateRange: { start: string; end: string }
  summary: string
  summaryZh?: string
  completedIssues: string[]  // Issue IDs
  evaluations: {
    strengths: BilingualText[]
    weaknesses: BilingualText[]
    improvements: BilingualText[]
  }
  mindsetAnalysis: {
    strengths: BilingualText[]
    weaknesses: BilingualText[]
    suggestions: BilingualText[]
  }
}

Common Tasks

Adding a New UI Component

Create file in packages/ui/src/components/ui/
Use Radix UI primitives
Export from packages/ui/src/index.ts
Follow existing component patterns

Fetching Fresh Data

cd apps/web
node scripts/fetch-issues.js    # Update issues.json
node scripts/fetch-agents.js    # Update projects.json
node scripts/generate-weekly.js # Update weekly.json

Building for Production

cd apps/web
STATIC_EXPORT=true pnpm build
# Output: apps/web/dist/

GitHub Pages Deployment

Push to main branch
GitHub Actions workflow runs automatically
Ensure Pages is enabled in repository settings

Component Library Details

Available Categories

Forms: Button, Input, Textarea, Select, Checkbox, Radio, Switch, Slider
Layout: Card, Dialog, Sheet, Sidebar, Tabs, Accordion, Collapsible
Navigation: Breadcrumb, NavigationMenu, Pagination, Menubar
Data Display: Table, Badge, Avatar, Progress, Skeleton, Chart
Feedback: Alert, Toast, Sonner, Spinner, Empty
Overlay: Popover, Tooltip, HoverCard, DropdownMenu, ContextMenu

Styling Approach

Tailwind CSS utility classes
Dark mode support via dark: modifiers
Custom markdown styles in globals.css

Notes

Static Export: Site is built as static HTML for GitHub Pages
Server Components: Used for markdown rendering at build time
Client Components: Used for interactive features (navigation, filters)
Data Storage: JSON files committed to repository
Bilingual Support: Weekly summaries support Chinese and English

Cheatsheet

interface CheatsheetMeta {
  slug: string
  title: string
  category: string
  tags: string[]
  keywords: string[]
  updated: string | null
  weight: number
  intro: string | null
  description: string
}

interface Cheatsheet extends CheatsheetMeta {
  content: string
}

AI Agent Guidelines

WriteAgent Skill

本项目使用 .trae/skills/write-agent/ 来维护文档更新。在以下情况时必须更新文档：

完成 Task 后 - 标记任务为完成状态，添加完成摘要
修改架构后 - 更新 AGENTS.md 中的架构说明
新增组件/模块 - 添加到组件列表，更新接口定义
修改配置后 - 更新配置说明和示例

文档更新原则:

及时更新：将文档更新视为任务的一部分
精确描述：准确描述实现的内容
保持结构：遵循现有文档的格式和风格
版本追踪：记录重要的变更历史

Dependencies of Note

@radix-ui/* - Accessible UI primitives
lucide-react - Icon library
unified + remark-parse + remark-gfm - Markdown processing
rehype-highlight - Code syntax highlighting
next-themes - Theme management
recharts - Chart library