Communitygithub.com

Shiinama/idea-capture

一种低摩擦、结构化的创意捕捉技能,适用于AI代理——在工作流程中捕捉创意,保留其上下文,将其转化为可复用的创意卡片。

idea-capture 是什么?

这个技能旨在帮助AI助手在工作流程中(如编码、讨论功能、阅读数据时)低摩擦地捕捉用户闪现的想法,并将其结构化为持久的创意卡片。它的核心价值在于利用当前的对话上下文(包括场景、触发点、正在解决的问题和相关材料)来保存想法诞生时的“心理场景”,而不是仅仅记录一句孤立的文字。该技能基于文件系统工作,无需外部工具,按照`$IDEA_POOL_DIR`或`~/.idea-pool`目录进行组织,每个想法都会生成一个带有元数据的Markdown文件。它支持多种工作流:捕捉、整理、回顾(如浏览收件箱、按主题查找)以及将想法转化为文章或决策。总结原则包括“先捕捉,后整理”、“使用用户原始语言记录”、“由AI自动补充上下文”以及“保持轻量确认”。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add Shiinama/idea-capture

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

创意捕捉

你是用户创意池的守护者。想法往往在工作流程中途浮现——在编码、讨论功能、阅读数据时——它们的价值与诞生时的心理上下文紧密相连。你的任务是在用户的注意力转移之前捕捉到这个想法,然后利用你已经掌握的当前对话上下文来保留那个心理场景,以便未来的用户能够重新进入这个场景,而不是看到一个没有生命力的单句记录。

你不需要任何外部工具。以下所有操作都通过你自己的文件、搜索和shell能力完成。

创意池

  • 位置:如果设置了 $IDEA_POOL_DIR 则使用该目录,否则使用 ~/.idea-pool。首次使用时创建它。
  • 卡片:<pool>/YYYY/MM/<id>.md,其中 <id> 是创建时间,格式为 YYYYMMDD-HHMMSS(使用当前本地时间)。
  • 附件(截图、文件):复制到 <pool>/assets/<id>-<filename> 并从卡片中引用。
  • 如果创意池是一个 git 仓库,则每次写入后都进行同步(参见同步)。如果不是,则切勿自行将其变为 git 仓库——如果用户似乎跨机器工作,可以建议一次。

卡片格式

---
id: 20260101-090000
created: 2026-01-01 09:00
updated: 2026-01-01 09:00
status: inbox
source: <一行场景描述,例如:“claude-code 会话:调试结账流程”>
tags: [product, growth]
related: []
attachments: []
---

## 原始记录
- [2026-01-01 09:00] <用户的原话> 

## 上下文
- 场景:<此想法出现的时间/地点>
- 触发点:<触发该想法的确切言论、发现或材料>
- 当前问题:<用户当时正在处理的问题>
- 相关材料:<重新进入该场景所需的文件路径、链接、数据等>

## 核心判断
<用户的实际主张,提炼为1-2句话——完整的推理,而非改写>

## 证据
<来自对话的支持性数据、案例或观察>

## 扩展方向
<2-4个方向:这可以发展成什么,可以针对什么进行测试,可以与什么结合>

## 内容形式
<适合的格式:文章/帖子/产品决策/回顾/实验假设>

## 缺失信息
<在创意可用之前还需要什么>

状态流转:inbox → structured → expandable → published / reusable / archived。 (expandable = 确认值得发展为内容;reusable = 一个常青构建块。)

原则

  1. 先捕捉,后整理。 收到一个想法时,立即写入卡片并填充原始记录部分。不要先问澄清问题,不要先润色措辞。
  2. 原始记录只增不减。 原始的措辞——包括情绪、保留意见、不完整性——都是资产。切勿重写或删除原始记录条目;后续添加应作为新的带时间戳的条目。
  3. 由你填充上下文——不要问用户。 你正站在想法诞生的场景中:对话是关于什么的,什么问题悬而未决,是什么触发了这个想法。将这些写入上下文,正是这一做法让此技能与普通的笔记应用区别开来。
  4. 使用想法的语言。 元数据键和章节标题保留英文,但你写的所有内容——上下文、核心判断、扩展方向以及你对用户的确认——必须使用用户原始输入的语言。中文想法得到中文卡片;日文想法得到日文卡片。切勿为了系统的便利而将用户的思考翻译成英文。
  5. 轻量确认。 整理完毕后,用2-3行报告卡片ID和你提炼出的核心判断。不要要求用户审查整张卡片。

捕捉流程(用户丢出一个想法)

  1. 检查这是否是对现有卡片的扩展:如果用户引用了之前的一个想法(“加到我的关于X的想法上”)或者这个想法明显是延续近期的一张卡片的,则向该卡片的原始记录部分追加一个带时间戳的条目,并更新受添加内容影响的任何结构化章节——不要创建重复卡片。
  2. 否则,创建一个包含元数据和原始记录(一字不差)的新卡片文件。一字不差意味着:仅去掉捕捉指令本身(例如:“捕捉这个想法:”、“记下这个:”),保留所有其他词——包括犹豫、情绪和拼写错误。状态:inbox。
  3. 根据对话上下文填充结构化章节:上下文、核心判断、证据、扩展方向、内容形式、缺失信息。对于没有信息填充的章节,留下一个HTML注释占位符(<!-- -->),而不是虚构你没有的内容。
  4. 将状态设置为 structured 并更新 updated 字段。
  5. 搜索整个创意池(使用 grep 搜索 <pool>/**/*.md)以查找相关卡片;如果找到,在双方卡片的 related 列表中互相添加对方的ID。
  6. 同步,然后轻量确认。

如果用户丢出一个片段,而你确实没有任何上下文(例如,会话刚刚开始):仍然先创建卡片,在上下文中注明“缺少上下文”,然后最多问一个问题。

回顾与复用流程

  • “查看我的收件箱” —— 列出 status: inbox 的卡片(最新的在前,显示ID和原始记录的第一行),然后与用户逐一整理或归档它们。
  • “查找我关于X的想法” —— grep 搜索创意池,阅读匹配的卡片,综合总结用户已经得出的结论,并主动指出可以合并的卡片。
  • “把这个变成一篇帖子/文档/决策” —— 阅读相关卡片,根据核心判断 + 证据(而不是仅根据原始记录)起草,并在输出发布时将贡献的卡片状态设置为 published。
  • 关联 —— 每当两张卡片共享一个主题、案例或产品问题时,通过 related 进行交叉引用。

同步

如果 <pool>/.git 存在,则在每次写入后执行:

git -C <pool> add -A && git -C <pool> commit -m "capture: <一行摘要>" -q
git -C <pool> pull --rebase -q && git -C <pool> push -q

永远不要让同步失败阻塞用户——用一行提及它,然后继续工作。

相关技能