449 lines
16 KiB
Markdown
449 lines
16 KiB
Markdown
---
|
||
categories:
|
||
- '[[LLM Wiki]]'
|
||
tags:
|
||
- wiki
|
||
- prompt-engineering
|
||
- template
|
||
created: 2026-04-08
|
||
source: '[[llm-wiki]]'
|
||
type: concept
|
||
aliases:
|
||
- Idea File 模板
|
||
- 提示词模板
|
||
- Prompt Template
|
||
relations:
|
||
- type: part_of
|
||
target: '[[Obsidian]]'
|
||
description: 同源：llm-wiki
|
||
confidence: 3
|
||
- type: extends
|
||
target: '[[RAG vs 持久化知识库]]'
|
||
confidence: 2
|
||
- type: extends
|
||
target: '[[BYOAI]]'
|
||
confidence: 2
|
||
---
|
||
|
||
# 优秀提示词的结构化模板 — Idea File 模式
|
||
|
||
> 基于 Karpathy 的 llm-wiki.md 分析提炼
|
||
|
||
---
|
||
|
||
## 核心理念
|
||
|
||
> "在这个 LLM Agent 的时代，分享具体的代码或应用已经意义不大了。你只需要分享想法，然后对方的 Agent 会根据你的具体需求来定制和构建。"
|
||
|
||
这是 **Idea File（想法文件）** 模式的核心：**只分享思路，不分享代码；Agent 会帮你实现具体细节。**
|
||
|
||
---
|
||
|
||
## Idea File 模板结构
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────┐
|
||
│ 1. 标题 (Title) │
|
||
│ - 一句话定义 (One-liner) │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 2. 核心思想 (The Core Idea) │
|
||
│ - 当前问题/主流方式 │
|
||
│ - 新的方法/理念 │
|
||
│ - 关键差异点 │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 3. 应用场景 (Examples) │
|
||
│ - 场景1 │
|
||
│ - 场景2 │
|
||
│ - 场景3 │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 4. 架构设计 (Architecture) │
|
||
│ - 层1：xxx │
|
||
│ - 层2：xxx │
|
||
│ - 层3：xxx │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 5. 核心操作/工作流 (Operations) │
|
||
│ - 操作1：描述 + 示例 │
|
||
│ - 操作2：描述 + 示例 │
|
||
│ - 操作3：描述 + 示例 │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 6. 关键组件 (Key Components) │
|
||
│ - 组件1：用途 │
|
||
│ - 组件2：用途 │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 7. 工具推荐 (Tools & Tips) │
|
||
│ - 工具1 │
|
||
│ - 工具2 │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 8. 为什么有效 (Why This Works) │
|
||
│ - 原理分析 │
|
||
│ - 优势说明 │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 9. 说明 (Note) │
|
||
│ - 可定制性 │
|
||
│ - 模块化原则 │
|
||
└─────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 各部分详解
|
||
|
||
### 1. 标题 + 一句话定义
|
||
|
||
```markdown
|
||
## LLM Wiki
|
||
|
||
A pattern for building personal knowledge bases using LLMs.
|
||
```
|
||
|
||
**目的**：让 Agent 立即理解这是关于什么的
|
||
|
||
---
|
||
|
||
### 2. 核心思想 (The Core Idea)
|
||
|
||
**包含三个部分**：
|
||
|
||
| 部分 | 说明 | 示例 |
|
||
|
|
||
------|
|
||
------|------|
|
||
| **当前问题** | 主流方式的痛点 | "Most people's experience with LLMs looks like RAG…" |
|
||
| **新方法** | 你的创新方案 | "Instead of retrieving, the LLM incrementally builds…" |
|
||
| **关键差异** | 为什么这更好 | "The wiki is a persistent, compounding artifact" |
|
||
|
||
---
|
||
|
||
### 3. 应用场景 (Examples)
|
||
|
||
使用 **场景 → 价值** 格式：
|
||
|
||
```markdown
|
||
- **Personal**: tracking goals, health, psychology...
|
||
- **Research**: going deep on a topic over weeks...
|
||
- **Reading a book**: filing each chapter as you go...
|
||
```
|
||
|
||
让 Agent 理解适用范围，不限定死实现方式。
|
||
|
||
---
|
||
|
||
### 4. 架构设计 (Architecture)
|
||
|
||
使用**分层**或**组件**结构：
|
||
|
||
```markdown
|
||
There are three layers:
|
||
- **Raw sources** — your curated collection...
|
||
- **The wiki** — LLM-generated markdown files...
|
||
- **The schema** — a document that tells the LLM...
|
||
```
|
||
|
||
每层清晰定义职责，便于 Agent 理解全局。
|
||
|
||
---
|
||
|
||
### 5. 核心操作/工作流 (Operations)
|
||
|
||
**三种操作**模式：
|
||
|
||
```markdown
|
||
**Ingest.** You drop a new source... [描述 + 示例流程]
|
||
|
||
**Query.** You ask questions... [描述 + 输出形式]
|
||
|
||
**Lint.** Periodically, ask the LLM to health-check... [描述 + 检查项]
|
||
```
|
||
|
||
每个操作包含：触发条件、执行流程、预期产出。
|
||
|
||
---
|
||
|
||
### 6. 关键组件 (Key Components)
|
||
|
||
```markdown
|
||
Two special files help navigate:
|
||
- **index.md** is content-oriented...
|
||
- **log.md** is chronological...
|
||
```
|
||
|
||
说明核心组件及其作用，而非完整实现细节。
|
||
|
||
---
|
||
|
||
### 7. 工具推荐 (Tips and Tricks)
|
||
|
||
```markdown
|
||
- **Obsidian Web Clipper** is a browser extension...
|
||
- **qmd** is a good option...
|
||
```
|
||
|
||
推荐工具但不强制，保持灵活性。
|
||
|
||
---
|
||
|
||
### 8. 为什么有效 (Why This Works)
|
||
|
||
```markdown
|
||
The tedious part is not the reading or thinking—
|
||
it's the bookkeeping. LLMs don't get bored...
|
||
```
|
||
|
||
解释**原理**而非具体实现，让 Agent 理解本质后可自行扩展。
|
||
|
||
---
|
||
|
||
### 9. 说明 (Note) — 最重要的一部分
|
||
|
||
```markdown
|
||
This document is intentionally abstract.
|
||
It describes the idea, not a specific implementation.
|
||
The exact directory structure... will depend on your domain.
|
||
The right way to use this is to share it with your LLM agent
|
||
and work together to instantiate a version that fits your needs.
|
||
```
|
||
|
||
**核心意图**：这是想法，不是实现；请根据你的需求定制。
|
||
|
||
---
|
||
|
||
## Idea File 的核心原则
|
||
|
||
| 原则 | 说明 |
|
||
|------|------|
|
||
| **分享想法，不给代码** | 只描述"做什么"，不规定"怎么做" |
|
||
| **抽象但具体** | 说明理念但不限定实现细节 |
|
||
| **模块化** | 每个部分独立，可选择使用 |
|
||
| **可扩展** | "Your agent will build out the specifics" |
|
||
| **协作式** | "Work together with your LLM agent" |
|
||
|
||
---
|
||
|
||
## 相关页面
|
||
|
||
- [[LLM Wiki]] — 模板的实际应用案例
|
||
- [[RAG vs 持久化知识库]] — 背景对比
|
||
- [[BYOAI]] — 自带 AI 概念
|
||
- [[Contamination Mitigation]] — 另一个 Idea File 示例
|
||
|
||
## 来源
|
||
|
||
---
|
||
## 核心概念
|
||
|
||
| 页面 | 简介 |
|
||
|------|------|
|
||
| [[Idea File 模板]] | Agent时代的思路分享范式 |
|
||
|
||
- [[llm-wiki]] — Karpathy Gist 原文
|
||
|
||
# 优秀提示词的结构化模板 — Idea File 模式
|
||
|
||
> 基于 Karpathy 的 llm-wiki.md 分析提炼
|
||
|
||
---
|
||
|
||
## 核心理念
|
||
|
||
> "在这个 LLM Agent 的时代，分享具体的代码或应用已经意义不大了。你只需要分享想法，然后对方的 Agent 会根据你的具体需求来定制和构建。"
|
||
|
||
这是 **Idea File（想法文件）** 模式的核心：**只分享思路，不分享代码；Agent 会帮你实现具体细节。**
|
||
|
||
---
|
||
|
||
## Idea File 模板结构
|
||
|
||
```
|
||
┌─────────────────────────────────────────────────────────┐
|
||
│ 1. 标题 (Title) │
|
||
│ - 一句话定义 (One-liner) │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 2. 核心思想 (The Core Idea) │
|
||
│ - 当前问题/主流方式 │
|
||
│ - 新的方法/理念 │
|
||
│ - 关键差异点 │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 3. 应用场景 (Examples) │
|
||
│ - 场景1 │
|
||
│ - 场景2 │
|
||
│ - 场景3 │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 4. 架构设计 (Architecture) │
|
||
│ - 层1：xxx │
|
||
│ - 层2：xxx │
|
||
│ - 层3：xxx │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 5. 核心操作/工作流 (Operations) │
|
||
│ - 操作1：描述 + 示例 │
|
||
│ - 操作2：描述 + 示例 │
|
||
│ - 操作3：描述 + 示例 │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 6. 关键组件 (Key Components) │
|
||
│ - 组件1：用途 │
|
||
│ - 组件2：用途 │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 7. 工具推荐 (Tools & Tips) │
|
||
│ - 工具1 │
|
||
│ - 工具2 │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 8. 为什么有效 (Why This Works) │
|
||
│ - 原理分析 │
|
||
│ - 优势说明 │
|
||
├─────────────────────────────────────────────────────────┤
|
||
│ 9. 说明 (Note) │
|
||
│ - 可定制性 │
|
||
│ - 模块化原则 │
|
||
└─────────────────────────────────────────────────────────┘
|
||
```
|
||
|
||
---
|
||
|
||
## 各部分详解
|
||
|
||
### 1. 标题 + 一句话定义
|
||
|
||
```markdown
|
||
## LLM Wiki
|
||
|
||
A pattern for building personal knowledge bases using LLMs.
|
||
```
|
||
|
||
**目的**：让 Agent 立即理解这是关于什么的
|
||
|
||
---
|
||
|
||
### 2. 核心思想 (The Core Idea)
|
||
|
||
**包含三个部分**：
|
||
|
||
| 部分 | 说明 | 示例 |
|
||
|------|------|------|
|
||
| **当前问题** | 主流方式的痛点 | "Most people's experience with LLMs looks like RAG…" |
|
||
| **新方法** | 你的创新方案 | "Instead of retrieving, the LLM incrementally builds…" |
|
||
| **关键差异** | 为什么这更好 | "The wiki is a persistent, compounding artifact" |
|
||
|
||
---
|
||
|
||
### 3. 应用场景 (Examples)
|
||
|
||
使用 **场景 → 价值** 格式：
|
||
|
||
```markdown
|
||
- **Personal**: tracking goals, health, psychology...
|
||
- **Research**: going deep on a topic over weeks...
|
||
- **Reading a book**: filing each chapter as you go...
|
||
```
|
||
|
||
让 Agent 理解适用范围，不限定死实现方式。
|
||
|
||
---
|
||
|
||
### 4. 架构设计 (Architecture)
|
||
|
||
使用**分层**或**组件**结构：
|
||
|
||
```markdown
|
||
There are three layers:
|
||
- **Raw sources** — your curated collection...
|
||
- **The wiki** — LLM-generated markdown files...
|
||
- **The schema** — a document that tells the LLM...
|
||
```
|
||
|
||
每层清晰定义职责，便于 Agent 理解全局。
|
||
|
||
---
|
||
|
||
### 5. 核心操作/工作流 (Operations)
|
||
|
||
**三种操作**模式：
|
||
|
||
```markdown
|
||
**Ingest.** You drop a new source... [描述 + 示例流程]
|
||
|
||
**Query.** You ask questions... [描述 + 输出形式]
|
||
|
||
**Lint.** Periodically, ask the LLM to health-check... [描述 + 检查项]
|
||
```
|
||
|
||
每个操作包含：触发条件、执行流程、预期产出。
|
||
|
||
---
|
||
|
||
### 6. 关键组件 (Key Components)
|
||
|
||
```markdown
|
||
Two special files help navigate:
|
||
- **index.md** is content-oriented...
|
||
- **log.md** is chronological...
|
||
```
|
||
|
||
说明核心组件及其作用，而非完整实现细节。
|
||
|
||
---
|
||
|
||
### 7. 工具推荐 (Tips and Tricks)
|
||
|
||
```markdown
|
||
- **Obsidian Web Clipper** is a browser extension...
|
||
- **qmd** is a good option...
|
||
```
|
||
|
||
推荐工具但不强制，保持灵活性。
|
||
|
||
---
|
||
|
||
### 8. 为什么有效 (Why This Works)
|
||
|
||
```markdown
|
||
The tedious part is not the reading or thinking—
|
||
it's the bookkeeping. LLMs don't get bored...
|
||
```
|
||
|
||
解释**原理**而非具体实现，让 Agent 理解本质后可自行扩展。
|
||
|
||
---
|
||
|
||
### 9. 说明 (Note) — 最重要的一部分
|
||
|
||
```markdown
|
||
This document is intentionally abstract.
|
||
It describes the idea, not a specific implementation.
|
||
The exact directory structure... will depend on your domain.
|
||
The right way to use this is to share it with your LLM agent
|
||
and work together to instantiate a version that fits your needs.
|
||
```
|
||
|
||
**核心意图**：这是想法，不是实现；请根据你的需求定制。
|
||
|
||
---
|
||
|
||
## Idea File 的核心原则
|
||
|
||
| 原则 | 说明 |
|
||
|------|------|
|
||
| **分享想法，不给代码** | 只描述"做什么"，不规定"怎么做" |
|
||
| **抽象但具体** | 说明理念但不限定实现细节 |
|
||
| **模块化** | 每个部分独立，可选择使用 |
|
||
| **可扩展** | "Your agent will build out the specifics" |
|
||
| **协作式** | "Work together with your LLM agent" |
|
||
|
||
---
|
||
|
||
## 相关页面
|
||
|
||
- [[LLM Wiki]] — 模板的实际应用案例
|
||
- [[RAG vs 持久化知识库]] — 背景对比
|
||
- [[BYOAI]] — 自带 AI 概念
|
||
- [[Contamination Mitigation]] — 另一个 Idea File 示例
|
||
|
||
## 来源
|
||
|
||
---
|
||
## 核心概念
|
||
|
||
| 页面 | 简介 |
|
||
|------|------|
|
||
| [[Idea File 模板]] | Agent时代的思路分享范式 |
|
||
|
||
- [[llm-wiki]] — Karpathy Gist 原文
|