跳到主内容
智客 ZICQ

技能库 智客分类:文档办公 hindsight-docs

Hindsight Docs

完成AI特工的暗视文件 利用这个来学习平视架构,API,配置,以及最佳做法.

7407 安装量

官方网址:skills.sh

技能介绍

先看中文介绍;官方 description 原文单独保留,不改写 SKILL.md。

做什么

完成AI特工的暗视文件 利用这个来学习平视架构,API,配置,以及最佳做法.

何时用

这个技能

代理如何加载

按 Agent Skills 渐进披露:启动时只加载 name 与 description(约 100 token);任务匹配后才读入整份 SKILL.md 正文;scripts/、references/、assets/ 仅在需要时再读。 本文件正文结构:Hindsight Documentation Skill、When to Use This Skill、Documentation Structure、How to Find Documentation、1. Find Files by Pattern (use Glob tool)、Core API operations。

文件分析

文件分析:除 SKILL.md 外,正文引用了 references/developer/api/、references/sdks/、references/sdks/integrations/、references/developer/api/retain.md、references/sdks/python.md、references/sdks/integrations/litellm.md,属于带资源的技能包,这些文件按需再读。

官方 description(原文)

Complete Hindsight documentation for AI agents. Use this to learn about Hindsight architecture, APIs, configuration, and best practices.

Hindsight Documentation SkillWhen to Use This SkillDocumentation StructureHow to Find Documentation1. Find Files by Pattern (use Glob tool)Core API operationsSDK documentationFind specific topics2. Search Content (use Grep tool)Search for conceptsSearch in specific areas3. Read Full Documentation (use Read tool)

来源分类:skills.sh agent-skill

SKILL.md 与 Agent 调用

官方规范 ↗
name
hindsight-docs
description
Complete Hindsight documentation for AI agents. Use this to learn about Hindsight architecture, APIs, configuration, and best practices.
  1. 发现技能客户端向 Agent 提供名称与描述目录。
  2. 匹配与调用用户指定或任务匹配后,载入 SKILL.md 指令。
  3. 按需加载按步骤读取参考文档、使用脚本与素材。
指令中引用的文件 · 8
  • references/developer/api/
  • references/sdks/
  • references/sdks/integrations/
  • references/developer/api/retain.md
  • references/sdks/python.md
  • references/sdks/integrations/litellm.md
  • references/best-practices.md
  • scripts/generate-docs-skill.sh

以下路径提取自原文;文件是否齐全请以来源仓库中的完整目录为准。

具体调用语法与可用工具以目标 Agent 客户端为准。 查看调用机制说明 ↗

安装这个技能

Skills CLI ↗

先选择目标 Agent 和安装范围,保留技能包的附属文件,安装后检查客户端能否发现该技能。

该技能引用了附属文件,请从来源获取完整目录;仅复制 SKILL.md 可能缺少依赖。

交给 Agent 安装

复制安装指令给支持 Agent Skills 的代理,确认其中的目标目录与客户端匹配。

把 Agent Skill「hindsight-docs」安装到我的项目:SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-1522f1124fac7f1c-%E5%90%8E%E8%A7%86%E9%81%93%E5%85%8B.html
请存为 .cursor/skills/hindsight-docs/SKILL.md 或 .claude/skills/hindsight-docs/SKILL.md,frontmatter 的 name 与 description 保持原样,不要改写。
该技能还带 scripts/、references/、assets/ 等文件,请从 https://github.com/vectorize-io/hindsight 取完整目录,不要只建一个 SKILL.md。

GitHub 完整包 ↗

终端安装 · Skills CLI

需要 Node.js 与 npx。先查看仓库技能列表,确认实际名称。

npx skills add 'https://github.com/vectorize-io/hindsight' --list

npx skills add 'https://github.com/vectorize-io/hindsight' --skill 'hindsight-docs'

CLI 会交互选择目标 Agent,默认安装到项目;用户级安装使用 -g。先通过查看命令核对仓库内容,再用 npx skills list 检查已安装技能。

阅读排版

name: hindsight-docs description: Complete Hindsight documentation for AI agents. Use this to learn about Hindsight architecture, APIs, configuration, and best practices.

Hindsight Documentation Skill

Complete technical documentation for Hindsight - a biomimetic memory system for AI agents.

When to Use This Skill

Use this skill when you need to:

  • Understand Hindsight architecture and core concepts
  • Learn about retain/recall/reflect operations
  • Configure memory banks and dispositions
  • Set up the Hindsight API server (Docker, Kubernetes, pip)
  • Integrate with Python/Node.js/Rust SDKs
  • Understand retrieval strategies (semantic, BM25, graph, temporal)
  • Debug issues or optimize performance
  • Review API endpoints and parameters

Documentation Structure

All documentation is in references/ organized by category:

references/
├── best-practices.md # START HERE — missions, tags, formats, anti-patterns
├── faq.md            # Common questions and decisions
├── changelog/        # Release history and version changes (index.md + integrations/)
├── openapi.json      # Full OpenAPI spec — endpoint schemas, request/response models
├── developer/
│   ├── api/          # Core operations: retain, recall, reflect, memory banks
│   └── *.md          # Architecture, configuration, deployment, performance
└── sdks/
    ├── *.md          # Python, Node.js, CLI, embedded
    └── integrations/ # Framework and tool integrations

How to Find Documentation

1. Find Files by Pattern (use Glob tool)

# Core API operations
references/developer/api/*.md

# SDK documentation
references/sdks/*.md
references/sdks/integrations/*.md

# Find specific topics
references/**/configuration.md
references/**/*python*.md
references/**/*deployment*.md

2. Search Content (use Grep tool)

# Search for concepts
pattern: "disposition"        # Memory bank configuration
pattern: "graph retrieval"    # Graph-based search
pattern: "helm install"       # Kubernetes deployment
pattern: "document_id"        # Document management
pattern: "HINDSIGHT_API_"     # Environment variables

# Search in specific areas
path: references/developer/api/
pattern: "POST /v1"           # Find API endpoints

path: references/sdks/
pattern: "def |async def "    # Find Python examples

3. Read Full Documentation (use Read tool)

references/developer/api/retain.md
references/sdks/python.md
references/sdks/integrations/litellm.md

Start Here: Best Practices

Before reading API docs, read the best practices guide. It covers practical rules for missions, tags, content format, observation scopes, and anti-patterns — the fastest way to integrate correctly.

references/best-practices.md

Key Concepts

  • Memory Banks: Isolated memory stores (one per user/agent)
  • Retain: Store memories (auto-extracts facts/entities/relationships)
  • Recall: Retrieve memories (4 parallel strategies: semantic, BM25, graph, temporal)
  • Reflect: Disposition-aware reasoning using memories
  • document_id: Groups messages in a conversation (upsert on same ID)
  • Dispositions: Skepticism, literalism, empathy traits (1-5) affecting reflect
  • Mental Models: Consolidated knowledge synthesized from facts

Notes

  • Code examples are inlined from working examples
  • Configuration uses HINDSIGHT_API_* environment variables
  • Database migrations run automatically on startup
  • Multi-bank queries require client-side orchestration
  • Use document_id for conversation evolution (same ID = upsert)

Auto-generated from hindsight-docs/docs/ and hindsight-docs/docs-integrations/. Run ./scripts/generate-docs-skill.sh to update.

相关技能

文档办公

Ontology

为结构化的代理内存和可堆肥技能所打入的知识图. 在创建/征服实体(Person, project, Task, Evention, Document)时使用,链接相关对象,强制约束,规划多步动作作为图变,或技能需要共享状态时使用. 触发到"记住","我知道什么","链接X到Y",…

文档办公

Nano Pdf

使用纳米-pdf CLI编辑带有自然语言指令的PDF.

文档办公

Word / DOCX

创建,检查,并编辑有可靠样式的Microsoft Word文档和DOCX文件,编号,跟踪更改,表格,章节,并进行相容性检查. 当 (1) 任务涉及 Word 或 ".docx " 时使用; (2) 文件包括跟踪的更改,评论,字段,表格,模板,或页面布局限制; (3) 文档必须在不…

文档办公

Api Gateway

通过 Maton 网关调用第三方 API, 它为用户已经连接的应用程序注入证书 。 当用户命名一个连接的应用程序和其中的具体行动时使用此技能——读取一个邮箱,查询一个CMM,归档一个问题,更新一个电子表格,通过一个连接的搜索或刮取提供者运行一个查询. 每一次通话都到用户连接的应用…