AgentSkillsCN

validated-knowledge-synthesis

通过系统化的验证过程,将原始且杂乱无章的信息转化为可付诸行动的知识。适用于用户希望从多种来源(文档、URL、转录本、笔记)中提炼信息,将其整理为结构化知识文档时使用。支持三种文档类型——精选情境(默认,优化记忆提取)、指导性文档(以实施为导向的叙述性内容),以及参考性文档(快速查阅)。结合收敛式综合与张力保留,以维持富有成效的矛盾冲突。可通过诸如“整合这些信息”、“从这些来源创建知识文档”、“将这些笔记转化为可执行的指导”、“帮我整理这些研究”等短语触发。

SKILL.md
--- frontmatter
name: validated-knowledge-synthesis
description: Transform raw, unorganized information into actionable knowledge through systematic validation. Use when users want to synthesize information from multiple sources (documents, URLs, transcripts, notes) into structured knowledge documents. Supports three document types - curated context (default, optimized for recall), guidance (implementation-focused narrative), and reference (quick lookup). Combines convergent synthesis with tension preservation to maintain productive contradictions. Triggers on requests like "synthesize this information", "create knowledge document from these sources", "transform these notes into actionable guidance", or "help me organize this research".

Validated Knowledge Synthesis (VKS)

Transform raw information into validated, actionable knowledge while preserving productive tensions.

Parameters

Acquire all required parameters upfront in a single prompt:

ParameterRequiredDescription
source_materialsYesRaw sources (direct text, file paths, URLs)
synthesis_topicYesSubject being synthesized
target_audienceYesIntended users of the knowledge
document_typeNo"curated context" (default), "guidance", or "reference"
output_locationNoFile path to save output

Support multiple input methods: direct text, file paths, URLs, or other user-preferred methods.

Workflow

1. Source Validation

Assess each source for:

  • Authority and credibility
  • Recency and relevance
  • Internal consistency
  • Citation quality

Create a source validation matrix. Flag sources lacking sufficient validation.

2. Pattern Recognition

Identify across sources:

  • Common themes and shared insights
  • Contradictory claims or competing frameworks
  • Gaps where sources don't address key aspects
  • Overlapping evidence strengthening claims

Categorize relationships as convergent (ideas strengthen each other) or tension-based (separation maintains value).

3. Synthesis Strategy Selection

Apply convergence when:

  • Ideas are complementary
  • Contradictions resolve at higher abstraction
  • Unified approach improves application
  • No valuable knowledge lost in combination

Apply tension preservation when:

  • Contradictions generate new insights
  • Different contexts require different approaches
  • Forced convergence would flatten valuable complexity

4. Document Type Execution

See references/document-types.md for detailed format specifications.

Curated Context (default): Hybrid of guidance and reference. Clear sections distinguishing each. Optimized for ease of recall.

Guidance: Narrative flow, problem-solution-implementation arc, 200+ words continuous prose before formatting, bullet points only for final checklists.

Reference: Quick lookup, categorical organization, bullet-friendly, designed for scanning.

5. Writing Execution

Apply these principles to all documents. See references/writing-principles.md for details.

  • Reader Empathy: Communicate key ideas in minimal words. Core tenet: "Learning how to communicate something in 30 seconds that takes most people 5 minutes is a HUGE unlock."
  • Short Sentences: Simple sentences build patience for complex concepts.
  • Strong Verbs: Use precise verbs. Avoid helpers (has, had), infinitives when direct verbs work, "to be" variations.
  • Simple Words: Choose simpler words (use not utilize, help not facilitate).

6. Apply Frameworks

See references/frameworks.md for complete framework details.

Golden Path Criteria: Purpose & Audience, Clear & Concise, Structure & Logic, Evidence & Impact, Action & Execution.

Answer-Explain-Educate: Lead with direct answer, support with key details, add important context.

What-So What-Now What: Present facts, analyze consequences, propose recommendation.

7. Validation

Verify:

  • Logical progression (premises support conclusions, no circular reasoning)
  • Narrative coherence (reader can follow logic without headers)
  • Flow validation (paragraphs connect logically)
  • Comprehension test (audience can understand and implement)

8. Output Generation

Create synthesis document including:

  • Executive summary with key insights
  • Source validation matrix
  • Synthesis strategy decisions with rationale
  • Convergent knowledge with evidence
  • Preserved tensions with context boundaries
  • Implementation guidance

Save to output_location if specified.

Troubleshooting

ProblemSolution
Forced convergence weakens knowledgeApply tension preservation instead
Validation failuresRevisit synthesis strategy; clarify context boundaries
Low-quality sourcesExclude or document limitations clearly
Excessive complexityCreate layered documentation (summary, analysis, appendices)
Fragmented narrativeAdd transitions, embed lists in prose, test without formatting