Files

T

hehaiguang1123 a6f05ab2d5 Phase 0-2: Schema cleanup, typed relations, event-driven automation

- Phase 0: AGENTS.md cleanup (dedup quotes, renumber sections, merge qmd)
- Phase 1: typed relations (manage-relations.py, graph-search.py, check-staleness.py, detect-conflicts.py)
- Phase 2: frontmatter validator, weekly lint, knowledge promotion, git hooks
- Fix .gitignore to track tools/ and .githooks/
- Fix git remote URL (remove plaintext token)
- New wiki pages: 504 pages, 34 raw sources

2026-07-01 08:05:43 +08:00

7.8 KiB

Raw Blame History

categories, tags, created, source, type, aliases

优秀提示词的结构化模板 — 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. 标题 + 一句话定义

## 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)

使用 场景 → 价值 格式：

- **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)

使用分层或组件结构：

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)

三种操作模式：

**Ingest.** You drop a new source... [描述 + 示例流程]

**Query.** You ask questions... [描述 + 输出形式]

**Lint.** Periodically, ask the LLM to health-check... [描述 + 检查项]

每个操作包含：触发条件、执行流程、预期产出。

6. 关键组件 (Key Components)

Two special files help navigate:
- **index.md** is content-oriented...
- **log.md** is chronological...

说明核心组件及其作用，而非完整实现细节。

7. 工具推荐 (Tips and Tricks)

- **Obsidian Web Clipper** is a browser extension...
- **qmd** is a good option...

推荐工具但不强制，保持灵活性。

8. 为什么有效 (Why This Works)

The tedious part is not the reading or thinking—
it's the bookkeeping. LLMs don't get bored...

解释原理而非具体实现，让 Agent 理解本质后可自行扩展。

9. 说明 (Note) — 最重要的一部分

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"

来源

核心概念

页面	简介
Idea File 模板	Agent时代的思路分享范式

llm-wiki — Karpathy Gist 原文

7.8 KiB Raw Blame History Unescape Escape