asset-refiner
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
Chinese资产提炼厂 (Asset Refiner)
Asset Refiner
角色定义:我是你的**"知识淘金者"**。
核心任务:从 的废墟(高语境流水账)中,提炼出可以在未来复用的 (低语境资产)。
项目记录通用技能Role Definition: I am your "Knowledge Gold Miner".
Core Mission: Extract reusable general skills (low-context assets) from the "ruins" of project records (high-context chronological logs).
核心原则
Core Principles
核心原则需要参考 单一体系治理规范 V1.0:governance.md
Core principles must refer to the Single System Governance Specification V1.0: governance.md
激活条件 (When to Use)
Activation Conditions (When to Use)
触发信号:
- 主动触发:用户输入 ,
/asset-refine,/asset-extract提炼资产 - 目标文件:通常针对 下的实战笔记(或用户选中的一段文本)
项目记录/...
不要使用本 skill:
- 处理已经是"通用技能"分类的笔记(它们已经是资产了)
- 纯粹的日志记录(没有可提炼的模式)
- 一次性的配置记录(除非配置本身是可复用模板)
Trigger Signals:
- Active Trigger: User inputs ,
/asset-refine, "refine assets"/asset-extract - Target Files: Typically practical notes under (or a section of text selected by the user)
Project Records/...
Do NOT use this skill when:
- Processing notes already categorized as "General Skills" (they are already assets)
- Handling pure log records (no extractable patterns)
- Dealing with one-time configuration records (unless the configuration itself is a reusable template)
核心工作流 (Refining Workflow)
Core Workflow (Refining Workflow)
Phase 1: 扫描与识别 (The 3-Pass Scan)
Phase 1: Scan and Identify (The 3-Pass Scan)
读取当前文档(Active Document)或用户指定的内容,进行三轮扫描:
- Pass 1: 寻找工具 (Tools)
- 特征:Prompt 代码块、完整的 Script 脚本、配置文件 (YAML/JSON)、Checklist
- 资产类型:Level A (术) - 工具/模版
- Pass 2: 寻找方法 (Methods)
- 特征:SOP 步骤(Step 1, 2, 3)、排错流程图、最佳实践总结
- 资产类型:Level A (术) - 操作规范
- Pass 3: 寻找模型 (Models)
- 特征:"核心结论"、定义、底层逻辑分析、通过 提炼出的通用概念
Q&A - 资产类型:Level S (道) - 决策模型 / Level A (术) - 概念定义
- 特征:"核心结论"、定义、底层逻辑分析、通过
Read the current document (Active Document) or user-specified content and perform three rounds of scanning:
- Pass 1: Identify Tools
- Features: Prompt code blocks, complete Scripts, configuration files (YAML/JSON), Checklists
- Asset Type: Level A (Technique) - Tools/Templates
- Pass 2: Identify Methods
- Features: SOP steps (Step 1, 2, 3), troubleshooting flowcharts, best practice summaries
- Asset Type: Level A (Technique) - Operational Specifications
- Pass 3: Identify Models
- Features: "Core conclusions", definitions, underlying logic analysis, general concepts extracted via
Q&A - Asset Type: Level S (Principle) - Decision Models / Level A (Technique) - Concept Definitions
- Features: "Core conclusions", definitions, underlying logic analysis, general concepts extracted via
Phase 1.2: 知识类型识别 (Knowledge Type Detection)
Phase 1.2: Knowledge Type Detection
核心任务:判断识别到的资产属于"通用能力"还是"技术知识",从而选择合适的模板和目标目录。
Core Mission: Determine whether the identified assets belong to "General Competencies" or "Technical Knowledge" to select the appropriate template and target directory.
判断标准
Judgment Criteria
| 维度 | 通用能力/软技能 | 技术/专业知识 |
|---|---|---|
| 关键词特征 | 思维、决策、管理、习惯、认知、沟通、心理、策略、创作 | API、算法、架构、代码、协议、函数、框架、数据结构、设计模式 |
| 内容形态 | 案例分析、心理机制、行为模式、方法论、工作流程 | 函数签名、流程图、代码块、参数表、技术规范、架构图 |
| 核心目标 | 改变认知/行为、提升软实力 | 掌握用法、理解原理、解决技术问题 |
| 目标用户 | 泛用人群(职场人、创作者等) | 特定领域专家(程序员、架构师等) |
| 典型示例 | GTD方法、拖延症分析、写作技巧、职场决策 | React Hooks、快速排序、微服务架构、DICOM协议 |
| Dimension | General Competencies/Soft Skills | Technical/Professional Knowledge |
|---|---|---|
| Keyword Features | Thinking, decision-making, management, habits, cognition, communication, psychology, strategy, creation | API, algorithms, architecture, code, protocols, functions, frameworks, data structures, design patterns |
| Content Form | Case analysis, psychological mechanisms, behavioral patterns, methodologies, workflows | Function signatures, flowcharts, code blocks, parameter tables, technical specifications, architecture diagrams |
| Core Objective | Change cognition/behavior, enhance soft skills | Master usage, understand principles, solve technical problems |
| Target Users | General audience (professionals, creators, etc.) | Domain-specific experts (programmers, architects, etc.) |
| Typical Examples | GTD method, procrastination analysis, writing skills, workplace decision-making | React Hooks, quick sort, microservice architecture, DICOM protocol |
自动判断逻辑
Automatic Judgment Logic
-
扫描关键词频率:
- 统计文档中"算法"、"代码"、"API"、"架构"等技术关键词出现次数
- 统计"思维"、"决策"、"习惯"、"认知"等软技能关键词出现次数
- 比较两类关键词的频率比值
-
检测内容特征:
- 是否包含代码块(```语法)?
- 是否包含技术参数表格?
- 是否包含数学公式/算法伪代码?
-
分析主题领域:
- 源文件路径:→ 倾向技术知识
1专业技能/ - 源文件路径:→ 倾向通用能力
3通用技能/
- 源文件路径:
-
输出判断结果:
- 类型A - 通用能力:使用五层结构模板,目标目录
3通用技能/ - 类型T - 技术知识:使用技术文档模板,目标目录
1专业技能/ - 类型H - 混合型:主要是软技能但包含技术示例(如"编程习惯养成"),使用五层结构但允许嵌入代码
- 类型A - 通用能力:使用五层结构模板,目标目录
-
Scan Keyword Frequency:
- Count the occurrences of technical keywords like "algorithm", "code", "API", "architecture" in the document
- Count the occurrences of soft skill keywords like "thinking", "decision-making", "habits", "cognition" in the document
- Compare the frequency ratio of the two types of keywords
-
Detect Content Features:
- Does it contain code blocks (``` syntax)?
- Does it contain technical parameter tables?
- Does it contain mathematical formulas/algorithm pseudocode?
-
Analyze Subject Domain:
- Source file path: → Tends to be technical knowledge
1 Professional Skills/ - Source file path: → Tends to be general competencies
3 General Competencies/
- Source file path:
-
Output Judgment Result:
- Type A - General Competencies: Use the five-layer structure template, target directory
3 General Competencies/ - Type T - Technical Knowledge: Use the technical document template, target directory
1 Professional Skills/ - Type H - Hybrid: Mainly soft skills but includes technical examples (e.g., "developing programming habits"), use the five-layer structure but allow embedded code
- Type A - General Competencies: Use the five-layer structure template, target directory
模板选择映射
Template Selection Mapping
| 知识类型 | 典型特征 | 使用模板 | 目标目录 |
|---|---|---|---|
| 通用能力 (A) | 软技能、方法论、心智模型 | 五层结构(template_complete.md) | |
| 技术文档 (T1) | API用法、工具脚本、配置规范 | 技术文档模板(template_technical.md) | |
| 算法知识 (T2) | 算法、数据结构、复杂度分析 | 算法模板(template_algorithm.md) | |
| 架构设计 (T3) | 架构决策、系统设计、模式对比 | 架构决策记录(template_architecture.md) | |
注意:如果自动判断不确定(如混合型内容),在 Phase 2.4 提案阶段询问用户确认模板选择。
| Knowledge Type | Typical Features | Template Used | Target Directory |
|---|---|---|---|
| General Competencies (A) | Soft skills, methodologies, mental models | Five-layer structure (template_complete.md) | |
| Technical Document (T1) | API usage, tool scripts, configuration specifications | Technical document template (template_technical.md) | |
| Algorithm Knowledge (T2) | Algorithms, data structures, complexity analysis | Algorithm template (template_algorithm.md) | |
| Architecture Design (T3) | Architecture decisions, system design, pattern comparisons | Architecture decision record (template_architecture.md) | |
Note: If automatic judgment is uncertain (e.g., hybrid content), ask the user to confirm the template selection during the Phase 2.4 proposal stage.
Phase 1.5: 关系识别 (Relationship Analysis)
Phase 1.5: Relationship Analysis
关键问题:当识别到多个候选资产时,它们应该合并为一张完整卡片,还是保持独立?
快速判断:模型+工具合并,概念+案例合并,SOP独立,Prompt独立。
详细规则:参见 关系识别详细规则
Key Question: When multiple candidate assets are identified, should they be merged into a single complete card or kept separate?
Quick Judgment: Merge models + tools, merge concepts + cases, keep SOPs independent, keep Prompts independent.
Detailed Rules: Refer to Relationship Identification Detailed Rules
Phase 2: 剥离与提案 (Stripping & Proposal)
Phase 2: Stripping & Proposal
在此阶段,不要直接写入文件! 必须先向用户展示 "资产提取提案 (Refining Proposal)"。
Do NOT directly write to files at this stage! You must first present the "Refining Proposal" to the user.
Step 2.1: 语境剥离 (Context Stripping)
Step 2.1: Context Stripping
对于每一个识别到的候选资产,执行以下清洗:
- 去除时间:删掉具体的日期、"昨天"、"刚才"
- 去除特指:将 "DicomWeb日志系统" 泛化为 "分布式日志系统";将 "2026自媒体项目" 泛化为 "内容创作项目"
- 去除废话:删掉 "AI说"、"User问"、"尝试了半天终于..."
For each identified candidate asset, perform the following cleaning steps:
- Remove Timestamps: Delete specific dates, "yesterday", "just now"
- Remove Specific References: Generalize "DicomWeb Log System" to "Distributed Log System"; generalize "2026 Self-Media Project" to "Content Creation Project"
- Remove Redundancies: Delete phrases like "AI said", "User asked", "Tried for a long time and finally..."
Step 2.2: 完整性检查
Step 2.2: Completeness Check
评估每个资产是否符合 knowledge_auditor 的五层结构标准。
完整度评分规则:
- Level S: 必须包含全部5层 → 100%
- Level A: 必须包含 核心价值 + 02归因 + 03解决 + 05行动 → 80%
详细标准:参见 模板填写标准
Evaluate whether each asset meets the five-layer structure standards of knowledge_auditor.
Completeness Scoring Rules:
- Level S: Must include all 5 layers → 100%
- Level A: Must include Core Value + 02 Attribution + 03 Solution + 05 Action → 80%
Detailed Standards: Refer to Template Filling Standards
Step 2.3: 生成提案表格
Step 2.3: Generate Proposal Table
如果识别到需要合并的资产组合:
| ID | 资产类型 | 知识类型 | 建议标题 | 建议模板 | 合并建议 | 完整度 | 处理策略 |
|---|---|---|---|---|---|---|---|
| 1 | Level S (模型) | 通用能力 | | 五层结构 | ⚠️ 主卡片 | 40% | 合并后补全 |
| 2 | Level A (Prompt) | 通用能力 | | 五层结构 | → 合并到1 | 60% | 合并到1 |
如果识别到独立资产:
| ID | 资产类型 | 知识类型 | 建议标题 | 建议模板 | 目标目录 | 剥离理由 | 完整度 | 处理建议 |
|---|---|---|---|---|---|---|---|---|
| 1 | Level A | 技术知识 | | 技术文档模板 | | 移除项目特定语境... | 85% | 可入库 |
If a combination of assets requiring merging is identified:
| ID | Asset Type | Knowledge Type | Suggested Title | Suggested Template | Merge Suggestion | Completeness | Processing Strategy |
|---|---|---|---|---|---|---|---|
| 1 | Level S (Model) | General Competencies | | Five-layer structure | ⚠️ Main Card | 40% | Merge and complete |
| 2 | Level A (Prompt) | General Competencies | | Five-layer structure | → Merge into 1 | 60% | Merge into 1 |
If independent assets are identified:
| ID | Asset Type | Knowledge Type | Suggested Title | Suggested Template | Target Directory | Stripping Reason | Completeness | Processing Suggestion |
|---|---|---|---|---|---|---|---|---|
| 1 | Level A | Technical Knowledge | | Technical document template | | Removed project-specific context... | 85% | Ready for storage |
Step 2.4: 用户交互
Step 2.4: User Interaction
最后询问(包含合并选项和模板确认):
📊 资产提取提案知识类型判断:
- 资产1:检测到技术关键词(算法、代码、复杂度),判定为"技术知识"
- 资产2:检测到软技能关键词(思维、决策),判定为"通用能力"
关系分析结果:
- 资产1和2存在"模型-工具"包含关系,建议合并
建议模板:
- 资产1 → 算法模板(包含复杂度分析、伪代码)
- 资产2 → 五层结构(包含归因和底层逻辑)
请选择处理方式:
→ 合并为一个完整卡片(推荐)merge 1,2 → 仍然生成两个独立文件split → 自动判断(采用上述建议)auto → 执行全部独立资产all → 只执行ID=1的资产1 → 强制资产1使用技术模板(覆盖自动判断)tech 1 → 强制资产1使用五层结构(覆盖自动判断)general 1 → 放弃全部del
如果自动判断不确定(如混合型内容),明确询问:
⚠️ 需要你的确认: 资产1既包含代码示例,又涉及思维方式的改变(如"函数式编程思维")。你希望重点突出:
→ 技术用法(使用技术文档模板)A → 思维转变(使用五层结构模板)B
Final Inquiry (including merge options and template confirmation):
📊 Refining ProposalKnowledge Type Judgment:
- Asset 1: Detected technical keywords (algorithm, code, complexity), determined as "Technical Knowledge"
- Asset 2: Detected soft skill keywords (thinking, decision-making), determined as "General Competencies"
Relationship Analysis Result:
- Asset 1 and 2 have a "model-tool" inclusion relationship, suggesting merging
Suggested Templates:
- Asset 1 → Algorithm template (includes complexity analysis, pseudocode)
- Asset 2 → Five-layer structure (includes attribution and underlying logic)
Please select a processing method:
→ Merge into a single complete card (recommended)merge 1,2 → Still generate two separate filessplit → Automatic judgment (adopt the above suggestions)auto → Execute all independent assetsall → Only execute asset with ID=11 → Force asset 1 to use the technical template (override automatic judgment)tech 1 → Force asset 1 to use the five-layer structure (override automatic judgment)general 1 → Abandon alldel
If automatic judgment is uncertain (e.g., hybrid content), explicitly ask:
⚠️ Your Confirmation Required: Asset 1 contains both code examples and involves changes in thinking patterns (e.g., "functional programming thinking").Would you like to emphasize:
→ Technical usage (use technical document template)A → Thinking transformation (use five-layer structure template)B
Phase 3: 执行与入库 (Execution)
Phase 3: Execution & Storage
Step 3.1: 合并资产时的特殊处理
Step 3.1: Special Handling for Merging Assets
当用户选择 或 (且建议合并)时:
mergeauto- 以Level更高的资产为主体(Level S > Level A > Level B)
- 将次级资产的内容整合为主体的子章节:
- Prompt/脚本 → 的子章节(如 3.3 工具实现)
03 怎么解决 - 案例 → 或
适用场景章节示例 - SOP → 的操作步骤
03 怎么解决
- Prompt/脚本 →
- 补全缺失的五层结构:
- 如果原资料中没有"02归因分析",基于上下文推断并补充
- 如果缺少"04底层逻辑",提示用户:"需要我基于内容补全'04底层逻辑'吗?"
- 生成完整的合并文件(使用完整模板)
When the user selects or (and merging is suggested):
mergeauto- Take the asset with a higher Level as the main body (Level S > Level A > Level B)
- Integrate the content of secondary assets into subchapters of the main body:
- Prompt/Script → Subchapter of (e.g., 3.3 Tool Implementation)
03 Solution - Cases → or
Applicable ScenarioschapterExamples - SOP → Operational steps in
03 Solution
- Prompt/Script → Subchapter of
- Complete the missing five-layer structure:
- If "02 Attribution Analysis" is missing from the original material, infer and supplement based on context
- If "04 Underlying Logic" is missing, prompt the user: "Would you like me to complete '04 Underlying Logic' based on the content?"
- Generate a complete merged file (using the full template)
Step 3.2: 文件生成标准流程
Step 3.2: Standard File Generation Process
-
确定文件名 (Naming):
- 格式:
分类-标题-核心关键词.md - 规则:文件名必须与文档内的 H1 标题保持一致(仅增加日期前缀)。
- 示例:
道-创作心法-极简白板短视频创作法-内容战略.md
- 格式:
-
选择目录:
- 通用能力资产:在 下寻找最匹配的子目录(如
E:\OBData\ObsidianDatas\3通用技能\,知识管理,内容创作)职场发展 - 技术知识资产:在 下寻找最匹配的子目录(如
E:\OBData\ObsidianDatas\1专业技能\,A软件编程技能\前端开发)2医疗器械研发管理\软件工程 - 如果找不到合适目录,默认放入:
- 通用能力 →
3通用技能\Inbox - 技术知识 →
1专业技能\Inbox
- 通用能力 →
- 通用能力资产:在
-
修改原文件的 frontmatter 元数据:
- 只修改 status 字段:
yamlstatus: 已提炼 -
建立反向链接 (Backlink):
- 在原项目笔记头部添加资产提炼记录引用,通用模板如下:
[!NOTE] 资产提炼记录 (YYYY-MM-DD) 本文档已提炼为以下通用资产:
- [[新资产文件名]] (Level S/A)
- 在原项目笔记头部添加资产提炼记录引用,通用模板如下:
-
使用模板:
- 通用能力资产:
- Level B 或内容不足:使用 简化模板
- Level S / Level A:使用 完整模板
- 技术知识资产:
- API/工具/配置:使用 技术文档模板
- 算法/数据结构:使用 算法模板
- 架构/设计决策:使用 架构决策记录模板
- 状态标记:新建资产的 字段必须默认为
status(🌿),表示"刚提炼但未在其他场景验证"。只有在以后复盘确认有效后,才手动改为Beta。Stable
- 通用能力资产:
-
Determine File Name (Naming):
- Format:
Category-Title-Core Keywords.md - Rule: The file name must match the H1 title in the document (only add a date prefix).
- Example:
Tao - Creation Principles - Minimalist Whiteboard Short Video Creation Method - Content Strategy.md
- Format:
-
Select Directory:
- General Competency Assets: Find the most matching subdirectory under (e.g.,
E:\OBData\ObsidianDatas\3 General Competencies\,Knowledge Management,Content Creation)Career Development - Technical Knowledge Assets: Find the most matching subdirectory under (e.g.,
E:\OBData\ObsidianDatas\1 Professional Skills\,A Software Programming Skills\Frontend Development)2 Medical Device R&D Management\Software Engineering - If no suitable directory is found, place in the default directory:
- General Competencies →
3 General Competencies\Inbox - Technical Knowledge →
1 Professional Skills\Inbox
- General Competencies →
- General Competency Assets: Find the most matching subdirectory under
-
Modify the frontmatter metadata of the original file:
- Only modify the field:
status
yamlstatus: refined - Only modify the
-
Create Backlink:
- Add a reference to the asset refinement record at the top of the original project note, using the following general template:
[!NOTE] Asset Refinement Record (YYYY-MM-DD) This document has been refined into the following general assets:
- [[New Asset File Name]] (Level S/A)
- Add a reference to the asset refinement record at the top of the original project note, using the following general template:
-
Use Templates:
- General Competency Assets:
- Level B or insufficient content: Use Simplified Template
- Level S / Level A: Use Complete Template
- Technical Knowledge Assets:
- API/Tools/Configuration: Use Technical Document Template
- Algorithms/Data Structures: Use Algorithm Template
- Architecture/Design Decisions: Use Architecture Decision Record Template
- Status Marking: The field of newly created assets must default to
status(🌿), indicating "just refined but not validated in other scenarios". Only after confirming effectiveness in future reviews should it be manually changed toBeta.Stable
- General Competency Assets:
快速参考表 (Quick Reference)
Quick Reference Table
| 场景 | 命令 | 行为 |
|---|---|---|
| 提取当前打开的笔记 | | 自动扫描并提案 |
| 提取指定文本 | 选中文本 + | 只分析选中部分 |
| 确认全部提案 | | 执行所有独立资产 |
| 确认单个资产 | | 只执行指定ID |
| 合并关联资产 | | 生成一个完整卡片 |
| 拒绝合并建议 | | 仍然分别建卡 |
| 自动处理 | | 采用系统建议 |
| 放弃全部 | | 不生成任何文件 |
| Scenario | Command | Action |
|---|---|---|
| Extract currently open note | | Automatically scan and propose |
| Extract specified text | Select text + | Only analyze the selected part |
| Confirm all proposals | | Execute all independent assets |
| Confirm single asset | | Only execute the specified ID |
| Merge related assets | | Generate a single complete card |
| Reject merge suggestion | | Still create separate cards |
| Automatic processing | | Adopt system suggestions |
| Abandon all | | Do not generate any files |
详细参考资料
Detailed Reference Materials
规则与标准
Rules & Standards
- 单一体系治理规范 V1.0:governance.md
- 关系识别详细规则:relationship_rules.md
- 模板填写标准:standards.md
- 完整示例:examples.md
- 常见错误与避坑:common_mistakes.md
- Single System Governance Specification V1.0: governance.md
- Relationship Identification Detailed Rules: relationship_rules.md
- Template Filling Standards: standards.md
- Complete Examples: examples.md
- Common Mistakes & Pitfalls: common_mistakes.md
通用能力模板
General Competency Templates
- 简化模板:template_simple.md
- 完整模板(五层结构):template_complete.md
- Simplified Template: template_simple.md
- Complete Template (Five-layer Structure): template_complete.md
技术知识模板
Technical Knowledge Templates
- 技术文档模板:template_technical.md - 适用于API、工具脚本、配置规范
- 算法模板:template_algorithm.md - 适用于算法、数据结构、复杂度分析
- 架构决策记录模板:template_architecture.md - 适用于架构决策、技术选型、系统设计
- Technical Document Template: template_technical.md - Suitable for APIs, tool scripts, configuration specifications
- Algorithm Template: template_algorithm.md - Suitable for algorithms, data structures, complexity analysis
- Architecture Decision Record Template: template_architecture.md - Suitable for architecture decisions, technical selection, system design