# AI-Native Workspace Framework

> 可组装的 AI-native 个人操作系统框架。通过初始化流程生成完整的、可直接执行的 workspace。

## 设计理念

这不是一个运行时的抽象层，而是一个**生成器**。用户回答几个问题，框架生成具体的、AI 可精确执行的 workspace 文件。

```
模板 + 用户配置 → 生成 → 完整 workspace（开箱即用）
```

类似 create-react-app：模板是输入，产出是具体项目。

## 架构

```
┌─────────────────────────────────────────────┐
│          Component Layer（组件层）            │
│  信息 │ 执行 │ 项目 │ 例行 │ 知识 │ 集成 │ 可视化 │
├─────────────────────────────────────────────┤
│          Foundation Layer（基础层）           │
│  原则 │ 模板 │ 检查点 │ 约定               │
└─────────────────────────────────────────────┘

领域配置（Areas）散布在各组件的配置项中，通过初始化流程统一收集。
```

## 使用方式

1. 复制本框架到新目录
2. 运行初始化 skill（AI 引导问答）
3. 得到完整的 workspace，包含具体的 steering、skills、目录结构
4. 开始使用

## 目录结构

```
workspace-template/
├── README.md                          # 本文件
├── foundation/                        # 基础层（直接复制，不需要改）
│   ├── principles.md                  # 核心原则
│   ├── checklists.md                  # 强制检查点
│   ├── conventions.md                 # 命名和格式约定
│   └── templates/                     # 通用模板
│       ├── project.md
│       └── task.md
├── components/                        # 组件层（每个组件 = 说明 + 模板）
│   ├── information/
│   │   └── README.md                  # 说明 + 配置项 + skill 模板
│   ├── execution/
│   │   └── README.md
│   ├── project/
│   │   └── README.md
│   ├── routine/
│   │   └── README.md
│   ├── knowledge/
│   │   └── README.md
│   ├── domain/
│   │   └── README.md
│   ├── integration/
│   │   └── README.md
│   └── visualization/                 # 可视化（SmartWorkSpace）
│       └── README.md
├── init/                              # 初始化流程（TODO）
│   └── INIT.md                        # 初始化 skill：问答 → 生成
└── examples/                          # 组装示例（完整配置参考）
    ├── work-management.md
    ├── life-management.md
    └── learning-system.md
```

## 初始化流程收集的信息（TODO: 实现）

1. Workspace 名称和用途（一句话）
2. 你管理什么领域？（Areas 列表）
3. 每个 Area 是否需要状态指示灯？
4. 启用哪些组件？
5. 回顾节奏？
6. 外部系统集成？
7. 语言偏好？（中文/英文/混合）

## 生成产物

初始化完成后，workspace 包含：
- `AGENTS.md` — AI 角色定义（含具体领域和行为准则）
- `.kiro/steering/` — 框架原则 + 结构定义 + 检查点
- `.kiro/skills/` — 具体的、可执行的 skill 文件
- `dashboard.md` — 仪表盘（含具体的状态表）
- Area 目录 + baseline 文件
- `projects/` 目录
- `templates/` 目录

## 状态

- [x] 基础层定义
- [x] 组件说明和配置项
- [x] 组装示例
- [ ] 初始化 skill（问答→生成）
- [ ] 组件 skill 模板（带插槽的 .tmpl 文件）
- [ ] 端到端测试（用初始化流程生成一个新 workspace）