IronClaw 想法停放（Idea Parking）技能全解析：从捕获灵感到承诺晋升的工作流

人工智能AI 应用交互助手AI Agent【免费下载链接】ironclawIronClaw is an Agent OS focused on privacy, security and extensibility项目地址https://gitcode.com/gh_mirrors/iro/ironclaw点击查看免费下载导读IronClaw 的 idea-parking 技能skills/idea-parking/SKILL.md是一套面向有趣但尚未可执行想法的生命周期管理机制将灵感持久化停放在projects/commitments/parked-ideas/由周期性的 digest 重新浮现并在条件成熟时晋升为正式承诺commitment或直接放弃。本文以该技能文档为骨架结合仓库中 memory 服务契约crates/domains/ironclaw_memory、commitment-triage、commitment-digest 等相邻技能完整讲解停放的四种操作停放、列出、晋升、放弃的实操命令、文件模板与底层执行原理帮助你在 IronClaw 中建立一条灵感 → 停放 → 重新浮现 → 承诺的闭环管线。一、技能定位IronClaw 的技能清单Skills体系在 IronClaw 中技能Skill是以SKILL.md文件形式分发的、带前导元数据frontmatter的指令包位于仓库根目录的 skills 目录下。每个技能的清单包含名称、版本、描述、激活条件activation、标签与上下文预算例如 idea-parking 的清单name: idea-parking version: 0.1.0 description: Park interesting ideas for later consideration, resurface them periodically, and promote to commitments when ready. activation: keywords: - park this - save for later - interesting idea - maybe someday - backburner - idea for later - might want to - parked ideas - idea pool - not now but - revisit later - shelve this patterns: - (?i)(park|save|shelf|shelve|backburner) (this|that|the) (idea|thought|concept) - (?i)not (now|yet|ready) but - (?i)(show|list|review) parked (ideas|items) - (?i)activate (idea|parked) tags: - commitments - ideas max_context_tokens: 1000这些字段不是装饰性的从 crates/domains/ironclaw_skills/src/types.rs 的源码可见ActivationCriteria在加载时会被强制限制——每技能关键词上限 20 个MAX_KEYWORDS_PER_SKILL、正则模式上限 5 个MAX_PATTERNS_PER_SKILL、标签上限 10 个MAX_TAGS_PER_SKILL超出部分在解析时静默丢弃。idea-parking 恰好声明了 12 个关键词与 4 个正则均处于配额之内。max_context_tokens: 1000则规定了该技能提示词可消耗的最大上下文 token 数用于约束激活时的上下文占用。技能声明了commitments与ideas两个标签这使其与 skills/commitment-triage/SKILL.md、skills/commitment-digest/SKILL.md 等承诺追踪家族技能共享同一分类空间便于在标签匹配时被一并召回。二、想法停放的存储位置与生命周期Idea Parking 的核心思想是想法与承诺分离管理。有趣但尚未可执行的想法如做一期 AWS vs GCP 对比视频调研 Rust WASM 性能不会立刻进入正式承诺列表而是以独立文档形式停放在虚拟文件路径projects/commitments/parked-ideas/下由 digest 定期重新浮现resurface避免说了就忘或过早承诺。这套虚拟路径位于 IronClaw 的 memory 文档仓库中。从 crates/domains/ironclaw_memory/src/path.rs 可以确认每个 memory 文档都解析为tenant_id / user_id / agent_id? / project_id?的MemoryDocumentScope加上一段相对路径relative_path形成形如/memory/tenants/{t}/users/{u}/agents/{a}/projects/{p}/projects/commitments/parked-ideas/slug.md的虚拟文件。路径验证是 fail-closed 的相对路径必须以正斜杠分隔、不得以/开头、不得包含\、空段、.与..遍历段也不得使用保留后缀.meta、.chunks、.versions这些是仓库元数据 sidecar 的命名空间详见 path.rs。在承诺体系中与parked-ideas/并列的还有路径用途相关技能projects/commitments/parked-ideas/停放的待定想法idea-parkingprojects/commitments/open/已确认的开放承诺commitment-triageMode Bprojects/commitments/signals/pending/被动提取、待分流的信号commitment-triageMode Aprojects/commitments/resolved/已解决的承诺commitment-triageMode Ccontext/intel/仅信息性、塑造未来决策的记忆文档commitment-triageMode D从 commitment-triage 的 Mode D信号晋升可以看到想法的正式入口当分流信号时parked_idea是信号的一个目的地——有趣但现在不做的信号会被写入parked-ideas/并在信号上标记destination: parked_idea。也就是说Idea Parking 与承诺提取是同一套工作区不同状态之间的流转。三、停放一个想法Parking an idea用户说出park this idea: do a comparison video of AWS vs GCP或save for later: investigate Rust WASM performance这类话时触发本技能。3.1 黄金规则成功 持久化成功技能文档明确强调一条不可妥协的规则本技能只有在停放的想法的确被持久化persisted时才算成功。不要只是确认或总结一个想法。执行顺序是强制的先调用memory_write写入projects/commitments/parked-ideas/slug.md然后才确认已停放。绝不能在对应的memory_write成功之前宣称某个想法已停放已保存稍后处理或稍后会重新浮现。这条规则在底层由MemoryService的写操作契约支撑。从 crates/domains/ironclaw_memory/src/service.rs 可见MemoryServiceWriteRequest从工具输入解析时对target做了提供者无关的越界防护reject_out_of_scope_target空白 target、以/开头的绝对路径、含..的遍历路径、反斜杠分隔符都会被拒绝为输入错误target为 JSONnull或缺失时才默认落到daily_log。此外除daily_log外append缺省值反而为true追加模式因此停放一个新想法时应当显式传append: false以确保整篇覆盖写入避免与旧内容拼接。写操作的状态经MemoryWriteStatus序列化为cleared/written/patched三种稳定线格式Agent 正是以该响应是否成功作为可确认停放的前提。3.2 停放文件模板写入projects/commitments/parked-ideas/slug.md的内容遵循如下模板完整保留自技能文档--- type: parked-idea parked_at: today YYYY-MM-DD source: conversation relevance: high|medium|low — infer from users enthusiasm tags: [relevant tags] --- # Idea title Description and why it is interesting. ## Activation trigger What would make this worth pursuing — a condition, event, or timeframe.各字段含义字段说明type: parked-idea固定标记用于与commitment、signal等类型区分parked_at停放日期格式YYYY-MM-DDsource来源示例为conversation也可扩展为其他来源标识relevance相关度分级high/medium/low按用户的热情程度推断tags相关标签数组便于后续按标签检索# Idea title想法标题描述段说明想法内容与为什么有趣## Activation trigger晋升触发条件什么条件、事件或时间点出现后值得认真推进Activation trigger是模板中最具设计价值的字段——它把何时值得做的判断权从停放时刻转移到了未来为 digest 的重新浮现提供了明确的判定依据。3.3 确认语句仅在写入成功后回复Parked:. Ill resurface it when the time seems right./p /blockquote这条回复同时预告了重新浮现resurface行为——即由 commitment-digest 在后续周期中把停放的条目带回用户视野。四、列出停放的Listing parked ideas用户说show parked ideas或whats on the backburner?时调用memory_tree(projects/commitments/parked-ideas/, depth1)列出该目录下所有文件跳过README.md对每个文件调用memory_read读取标题与relevance字段以简洁列表呈现Parked ideas: - **title** (parked date, relevance: level) - **title** (parked date, relevance: level)从 memory 服务契约看memory_tree对应MemoryServiceTreeRequestpath缺省为空、depth缺省为 1 且被clamp(1, 10)限制service.rs恰好符合只列一层目录文件的用法memory_read对应MemoryServiceReadRequest返回path、content、word_count三要素足以支撑标题与日期提取。该技能建议只展示标题、停放日期与相关度三级不展开全文以保持对话的轻量可扫读。五、晋升想法为承诺Promoting an idea用户说activate the comparison video idea或lets do the WASM performance investigation.时想法进入正式承诺通道在parked-ideas/中找到匹配的停放条目基于该想法的内容在projects/commitments/open/下创建一个承诺commitment文件将原停放文件覆盖为空内容即清空而非删除或保留副本确认Promoted to active commitment: title.这里的覆盖为空是承诺家族技能的通用惯例在 skills/commitment-triage/SKILL.md 的 Mode C解决承诺中同样使用memory_write(targetprojects/commitments/open/slug.md, content, appendfalse)来清理已解决条目。空内容写入而非物理删除意味着文档被清空在 memory 仓库中是可观测、可审计的状态同时避免破坏路径命名空间的稳定性。晋升后创建的承诺文件应采用 commitment-triage 的承诺模板commitment-triage/SKILL.md包含type: commitment、status: open、urgencycritical/high/medium/low、due、created_at、stale_after、owner、delegated_to、resolution_pathagent_can_handle/needs_reply/needs_decision/note_only等字段以及## Resolution path步骤清单。文件名遵循统一的 slugify 约定小写、连字符、无特殊字符、最长 50 字符例如 Review Sarahs deck →review-sarah-deck.md。六、放弃想法Dismissing an idea用户说dismiss the comparison video idea或drop that parked idea.时将对应文件覆盖为空内容确认Dismissed: title.与晋升流程一致放弃同样是清空文件 简短确认不做多余的安抚性总结。这保证了想法列表的一致性memory_tree列出的任何文件都代表一个仍然存活的条目被清空的文件不参与memory_read的内容提取自然从后续 digest 的重新浮现中排除。七、定期重新浮现与 commitment-digest 的协同停放想法的最终闭环依赖 commitment-digest 技能skills/commitment-digest/SKILL.md。digest 既可在对话中由用户直接触发show commitments也可由commitment-digestmission 定时投递。其数据收集阶段通过memory_tree(projects/commitments/open/)、memory_tree(projects/commitments/signals/pending/)等调用汇总承诺、待处理信号与近期解决项并将停放的条目周期性地带回用户视野——这正是 idea-parking 描述中 resurface them periodically 的落地方式。digest 还按stale_after标记stale — still relevant?、对超过 3 天未更新的委派项给出 follow-up 建议为停放想法提供了被重新审视的机会窗口。两条技能共享同一套数据源与工具约束digest 文档同样要求使用memory_tree与memory_read组装摘要禁止使用 CodeAct、shell 命令或创意生成工具来统计或总结承诺——这与 idea-parking 只通过 memory 工具操作工作区 的约束一致保证了整个承诺体系的操作面收敛在内存文档层。八、与相邻技能的完整链路Idea Parking 并不是孤立的。结合仓库中的技能族可以拼出完整的灵感处理管线灵感 / 被动信号commitment-triage Mode A 提取 │ 分流Mode D ▼ parked_idea ──► projects/commitments/parked-ideas/idea-parking 停放 │ │ │ ├─ activate ──► projects/commitments/open/晋升为承诺 │ ├─ dismiss ──► 清空放弃 │ └─ digest 定期 resurface ──► 重新评估捕获入口commitment-triage 的被动信号检测Mode A会从interesting but not now的表述中提取信号并在分流时将destination: parked_idea的条目写入parked-ideas/Mode D显式捕获Mode B则直接写入open/不经过停放环节。优先级参考skills/product-prioritization/SKILL.md 提供了评分框架Demand × 3 Impact × 2 Alignment × 1/ Effort可作为判断停放想法是否该晋升的证据工具。退役路径tech-debt-trackerskills/tech-debt-tracker/SKILL.md同样引用 parked 概念管理技术债想法说明parked-ideas/是跨技能共享的待定区。九、底层实现支撑memory 工具契约本技能依赖的四个核心 memory 工具在 crates/domains/ironclaw_memory/src/service.rs 中有稳定的能力标识capability id工具Capability ID对应请求类型memory_writeironclaw.memory.writeMemoryServiceWriteRequestmemory_readironclaw.memory.readMemoryServiceReadRequestmemory_treeironclaw.memory.treeMemoryServiceTreeRequestmemory_searchironclaw.memory.searchMemoryServiceSearchRequestmemory_profile_setironclaw.memory.profile_setMemoryServiceProfileSetRequestMemoryServicetrait 是提供者中立的内存契约见 crates/domains/ironclaw_memory/README.md所有 memory 提供者native 与 mem0 等实现同一套接口调用方只依赖契约不感知后端。这意味着memory_write(projects/commitments/parked-ideas/slug.md, ...)无论底层是 native 文件系统提供者crates/extensions/packages/memory-native还是 mem0crates/extensions/packages/mem0对技能而言行为一致。写请求的解析遵循宽松输入、严格边界原则可选字段错误类型会收敛到默认值但target越界空白、绝对路径、..、反斜杠会被立即拒绝service.rs这为停放路径提供了额外的安全性。十、实操要点与约束汇总将本技能落地为可复用的操作习惯需记住以下要点顺序不可颠倒任何操作都必须先完成memory_write持久化再输出确认语句没有成功的写操作就没有已停放已晋升已放弃。显式append: false停放、晋升、放弃都会覆盖整个文件务必显式关闭追加防止与历史内容拼接。模板字段不省略type、parked_at、source、relevance、tags与Activation trigger共同支撑 digest 的重新浮现与优先级判断缺字段会削弱后续检索与排序能力。清空即弃晋升与放弃都用空内容覆盖原文件保持parked-ideas/目录有文件即有效条目的不变量。工具边界只使用memory_tree/memory_read/memory_write等 memory 工具操作承诺工作区不使用 CodeAct 或 shell 命令做统计与总结。slug 规范文件名小写、连字符、去特殊字符、≤50 字符保证跨技能triage、digest、idea-parking路径引用一致。结语IronClaw 的 idea-parking 技能以持久化优先 状态流转 周期浮现三个设计支柱把模糊的稍后再说变成了可审计、可检索、可晋升的工作区状态。配合 commitment-triage 的捕获与分流、commitment-digest 的周期性 resurface以及 memory 提供者中立的MemoryService契约它构成了 Agent OS 中一条完整的想法→承诺治理闭环——这正是 IronClaw 面向隐私与可扩展性设计的个人任务管理能力的缩影。赞分享人工智能AI 应用交互助手AI Agent【免费下载链接】ironclawIronClaw is an Agent OS focused on privacy, security and extensibility项目地址https://gitcode.com/gh_mirrors/iro/ironclaw点击查看免费下载相关推荐Skills灵感流水线Daily UI Inspiration Capture每日UI灵感自动捕获工作流详解Skills灵感流水线Daily UI Inspiration Capture每日UI灵感自动捕获工作流详解 在 Skills 项目中 Daily UI IIronClaw Content Creator Setup用承诺系统与定时 Mission 搭建内容创作工作流IronClaw Content Creator Setup用承诺系统与定时 Mission 搭建内容创作工作流 本指南基于 IronClaw 仓库中的 co人工智能AI 应用交互助手AI AgentIronClaw 交易员承诺系统部署指南用 trader-setup 技能搭建实时信号、仓位感知与交易日志工作流IronClaw 交易员承诺系统部署指南用 trader setup 技能搭建实时信号、仓位感知与交易日志工作流 本文基于 IronClaw 仓库中的 tra人工智能AI 应用交互助手AI Agent上一篇Outline插件生态第三方集成全景指南下一篇深度解析Win11DebloatWindows系统优化的革命性解决方案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考