介绍
# Notebook Skill Object Based Personal Knowledge Base
用途：跟踪您定义的任何对象类型，例如想法、项目、任务、习惯、书籍和人员。
位置：{WORKSPACE}/skills/notebook/
## Agent 入门协议
在不存在对象类型时引导用户完成设置。
### 步骤 1 建议首个类型
``` It looks like you have not defined any object types yet. Notebook works best when you define the types of things you want to track.
What would you like to start with?
1. Ideas for capturing thoughts and features 2. Projects for long term work with goals 3. Tasks for actionable items with due dates 4. Something custom tell me what you want to track ```
### 步骤 2 共同定义类型
如果他们选择预设： ``` Great. Let us set up [type].
I will create it with useful fields. You can add or remove them later.
For [type], what fields do you want? - title (text, required) - status (select) - priority (select) - tags (text) - notes (longtext) - [custom fields]
What fields should [type] have? ```
如果他们想要自定义： ``` Tell me what you want to track and what details matter.
Example: I want to track books I read. I need title, author, status, rating, and notes.
I will translate that into a type definition. ```
### 步骤 3 创建首个对象
``` Now let us add your first [type].
What do you want to track as your first [type]?
Example: The Andromeda Strain for books or Home automation for projects ```
### 步骤 4 展示工作流
``` Perfect. You now have: - Type: [typename] with [N] fields - 1 [typename] object: [title]
What would you like to do next?
- notebook list [typename] to see all items - notebook expand [typename] [title] to add details - notebook add [typename] to add another - notebook type-add [typename] to add more fields later ```
### 步骤 5 提供扩展
``` Would you like to deepen this [typename] with some questions? Say expand and I will ask questions to add depth. ```
## 快速参考
### 定义类型
``` notebook type-add typename field1:text field2:select(a|b|c) field3:number ```
字段类型： - text 用于短字符串 - longtext 用于多行笔记 - select(a|b|c) 用于从列表中选择一个选项 - number 用于数值 - date 用于日期 - list 用于字符串数组
### 使用对象
``` notebook add typename "Title" [-t tag1,tag2 -p priority] notebook list typename notebook get typename title notebook expand typename title notebook edit typename "title" field:value notebook link type1:title1 type2:title2 notebook delete typename title notebook find "query" notebook stats ```
## 示例工作流
``` # 1. Define a type notebook type-add idea title:text status:select(raw|expanded|archived) priority:select(high|medium|low) tags:text notes:longtext
# 2. Add your first idea notebook add idea "Voice capture while driving" -t voice,automation -p high
# 3. Deepen it notebook expand idea "voice capture"
# 4. Link to other objects notebook add project "Home automation" -t household notebook link idea:"voice capture" project:"home automation"
# 5. Update as you work notebook edit idea "voice capture" status:expanded ```
## 数据位置
``` /data/notebook/ ├── objects/ ├── types.yaml └── index.json ```
## 设计原则
- 用户定义：您定义重要的类型。 - 本地优先：使用 YAML 文件，无云服务或厂商锁定。 - 可链接：对象可以相互引用。 - 可扩展：根据需要添加类型和字段。 - 可拓展：使用智能提问来深化思考。