Agent Skill · 研究检索

synapse-docs（突触文档）

用于辅助文档、README、Markdown、说明文和内容稿件的整理与改写。它适合让 Agent 提炼结构、补齐章节、统一术语、检查链接或把零散材料整理成可读文档。使用时应保留项目已有事实、命令和路径，不要把未确认的信息写成确定结论；涉及对外文案时，还需要控制语气，避免过度营销或夸大能力。

synapse-docs 是研究检索类 Agent Skill，可用宿主为 Codex、Claude、Cursor、Gemini CLI，通过GitHub 仓库获取，权限为接触敏感数据；许可证为 MIT，第三方扫描已通过，按安装量在研究检索类的 73,675 个 Skill 里排第 39,432。

总安装 1,416周安装 49GitHub Stars 4下载 388核验 2026-05-01

研究检索接触敏感数据 GitHub 仓库未标认证来源可访问许可证明确审计通过 Codex Claude Cursor Gemini CLI

安装说明

本站只整理中文说明，不托管安装包，也不代用户安装。

GitHub

许可证: MIT

安装方式

通过对话安装

复制提示词发给支持本地命令或 Skills 的 AI 助手，先确认命令和权限，再让它执行。

请帮我安装这个 Agent Skill：synapse-docs（突触文档）
来源仓库：https://github.com/s-hiraoku/synapse-a2a
仓库路径：skills/synapse-docs
安装命令：
npx skills add https://github.com/s-hiraoku/synapse-a2a --skill synapse-docs
安装前请先检查当前环境是否支持对应 CLI，并向我确认将要执行的命令、安装目录、联网范围和文件读写权限；确认后再执行。

命令行安装

复制命令到本机终端执行。不同来源提供的安装方式可能略有差异；本站展示可直接复制的安装命令，安装前请核对来源页面。

skills.shnpx skills

npx skills add https://github.com/s-hiraoku/synapse-a2a --skill synapse-docs

这个 Skill 是做什么的

研究检索类 Skill 主要解决「找资料、核对事实、把来源整理清楚」的问题，通常会让助手先检索再总结。

synapse-docs 用于辅助文档、README 和 Markdown 内容的整理与改写，适合在 Codex、Claude、Cursor、Gemini CLI 中提炼结构或统一术语时使用。适用于项目说明、技术写作或内容稿件优化等文档处理场景。可自动补齐章节、检查链接有效性，但需人工确认未核实信息的准确性。

安装命令为 npx skills add https://github.com/s-hiraoku/synapse-a2a --skill synapse-docs。涉及对外文案时应避免过度营销表述，保持语气克制客观。

来源仓库内路径：skills/synapse-docs

上手步骤

4 步

1
确认自己的宿主工具
公开资料标注支持 Codex、Claude、Cursor、Gemini CLI；先确认自己用的是其中之一，再按对应工具的 Skills 目录放置。
2
拿到安装命令
可以直接复制的命令是 npx skills add https://github.com/s-hiraoku/synapse-a2a --skill synapse-docs；命令里的占位符换成自己的路径或密钥再执行。
3
安装后重启宿主
命令执行完要完全退出宿主工具再打开，让新装的 Skill 被重新扫描到，否则列表里可能看不到。
4
按最小权限试用
它需要接触敏感数据，先在测试目录或测试账号里跑，确认没问题再放到正式项目。

常见问题

6 条

synapse-docs 怎么安装？

在终端执行 npx skills add https://github.com/s-hiraoku/synapse-a2a --skill synapse-docs。装完完全退出宿主工具再打开，让它重新扫描本地 Skill。

synapse-docs 支持哪些 AI 工具？

公开资料标注支持 Codex、Claude、Cursor、Gemini CLI。其他工具只要能读取本地 Skill 目录，一般也能手动放进去，但要自己确认触发方式是否一致。

synapse-docs 需要什么权限？

权限级别是接触敏感数据。该 Skill 可能接触密钥、Token、环境变量或敏感配置，应进入高风险复核队列，默认不自动发布。

synapse-docs 是免费的吗？

来源标注的许可证是 MIT。本站不代收任何费用，也不托管安装包；能否商用、要不要署名，以许可证原文为准。

synapse-docs 用的人多吗？

公开数据是累计安装 1,416 次，近一周安装 49 次，下载 388 次，GitHub 4 星。这些数字来自第三方目录统计，只能当作热度参考，不代表质量或安全性。

synapse-docs 安全吗？

第三方扫描结果为通过，但这只覆盖已知的静态检查项，不能替代自己读一遍源码和安装命令。

值得选的地方和要先想清楚的地方

值得选的地方

同时适配 4 种工具，换客户端不用重新找替代品。
3 个目录同时收录，说明这个 Skill 流传比较广。
许可证明确为 MIT，商用和分发边界好判断。
第三方扫描已通过，常见的高风险行为没有命中。

先想清楚的地方

需要接触敏感数据，装到常用环境前要先评估影响面。
第三方目录整理，版本更新和行为细节以来源仓库为准。

适不适合你

更适合

已经在用 Codex，想直接扩展它能力的人。
需要处理研究检索类任务、又不想每次都手写提示词的人。
需要许可证清楚、并且有第三方扫描结果的团队项目。

不太适合

环境里有大量密钥、凭证，不方便给第三方 Skill 读取的人。
需要厂商级技术支持和 SLA 的生产系统。

研究检索类 Skill 对比

6 个同类

Skill	总安装	GitHub 星	权限	许可证	扫描
find-skills 寻找技能 · Codex、Claude	31,199,813	16,486	操作浏览器	MIT	有提醒
self-improving-agent 自我改进 Agent · OpenClaw	16,464,002	3,396	接触敏感数据	MIT-0	通过
soultrace 灵魂追踪 · Codex、Claude	7,588,944	12	需要联网	未明确	有提醒
self-improving 自我完善 · OpenClaw	6,829,284	1,046	需要联网	MIT-0	通过
microsoft-foundry 微软代工厂 · Codex、Claude	6,614,144	764	调用外部服务	未明确	有提醒
synapse-docs 突触文档 · 本页	1,416	4	接触敏感数据	MIT	通过

按安装量取同分类前几名；数字来自第三方目录统计，只作热度参考，不代表质量结论。

SKILL.md 原文

Synapse Docs

This skill ensures Synapse A2A documentation stays synchronized with code changes.

When This Skill Activates

Automatic Triggers

Code changes in core modules - synapse/*.py, synapse/commands/*.py
Profile changes - synapse/profiles/*.yaml
Template changes - synapse/templates/.synapse/*
Plugin/Skill changes - plugins/synapse-a2a/**/*
Configuration changes - pyproject.toml (version, dependencies, entry points)

Manual Invocation

/synapse-docs - Run full documentation check and update

Workflow

Phase 1: Detect Changes

When code is modified, identify affected documentation by consulting references/code-doc-mapping.md.

Quick Reference - Common Patterns:

Change Type	Primary Docs	Secondary Docs
CLI command	`README.md`, `guides/usage.md`	`guides/references.md`, `CLAUDE.md`
API endpoint	`README.md`, `guides/references.md`	`guides/enterprise.md`
Environment variable	`README.md`, `guides/settings.md`	`templates/.synapse/settings.json`
Profile setting	`guides/profiles.md`	`CLAUDE.md`
Skill content	`plugins/*/SKILL.md`	`.claude/skills/`, `.agents/skills/`（`plugins/synapse-a2a/skills/` を編集し sync で配布）

Phase 2: Propose Updates

For each affected document:

Read the current content
Identify the specific section to update
Propose the minimal necessary change
Present changes to user for approval

Update Principles:

Maintain existing document style and tone
Update only affected sections
Keep README.md concise; put details in guides/
Ensure consistency across related documents

Phase 3: Synchronize Related Files

After updating primary documents, check for required synchronization:

Skill Synchronization:

plugins/synapse-a2a/skills/ → .claude/skills/
plugins/synapse-a2a/skills/ → .agents/skills/

Template Consistency:

synapse/templates/.synapse/ should match documentation in guides/settings.md

Phase 4: Verify Consistency

Run consistency checks:

CLI commands - Compare README.md ↔ guides/usage.md ↔ guides/references.md
API endpoints - Compare README.md ↔ guides/references.md
Port ranges - Compare README.md ↔ guides/multi-agent-setup.md ↔ CLAUDE.md
Environment variables - Compare README.md ↔ guides/settings.md ↔ templates/settings.json

Document Categories

User-Facing (High Priority)

Document	Purpose	Update Frequency
`README.md`	First impression, quick start	Every feature change
`guides/usage.md`	How to use	CLI/API changes
`guides/settings.md`	Configuration reference	Setting changes
`guides/troubleshooting.md`	Problem solving	New issues discovered

Developer-Facing

Document	Purpose	Update Frequency
`CLAUDE.md`	Development guide for Claude Code	Architecture/test changes
`guides/architecture.md`	Internal design	Component changes
`docs/*.md`	Technical specifications	Design changes

Plugin/Skill

Document	Purpose	Update Frequency
`plugins/synapse-a2a/README.md`	Plugin installation	Plugin changes
`plugins//skills//SKILL.md`	Skill instructions	Feature changes

Reference Files

For detailed document inventory and code-to-doc mappings, consult:

references/doc-inventory.md - Complete list of all documents and their roles
references/code-doc-mapping.md - Source file to document relationships

Special Cases

Version Updates

When pyproject.toml version changes:

Update CHANGELOG.md with release notes
Check if README.md test badge needs updating
Update plugins/synapse-a2a/.claude-plugin/plugin.json version if needed

New Feature Addition

For major new features:

Add to README.md feature table
Create or update relevant guide in guides/
Update CLAUDE.md if development workflow affected
Add to guides/README.md navigation if new guide created

Deprecation

When deprecating features:

Mark as deprecated in relevant docs
Add migration guide if needed
Update CHANGELOG.md
Remove from quick start examples in README.md

平台分布

Claude Code

30.46%

按下载量换算118

Gemini CLI

24.36%

按下载量换算95

windsurf

17.96%

按下载量换算70

trae

11.64%

按下载量换算45

OpenCode

7.9%

按下载量换算31

Cursor

3.41%

按下载量换算13

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

通过

权限和风险

接触敏感数据

该 Skill 可能接触密钥、Token、环境变量或敏感配置，应进入高风险复核队列，默认不自动发布。

安装前确认

本站仅展示第三方公开信息，不托管安装包，不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。

继续浏览同类 Skills

更多研究检索 Skills（73,675）返回 Skills 目录

上一个 Skill

synapse-code（突触代码）

ankechenlab-node/synapse-code

synapse-code 用于查找、检索和筛选相关信息，适合在 OpenClaw 中需要根据关键词、任务场景或来源线索快速定位候选结果时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。

下一个 Skill

synapse-layer（突触层）

rafacpti23/synapse-layer

synapse-layer 用于查找、检索和筛选相关信息，适合在 OpenClaw 中需要根据关键词、任务场景或来源线索快速定位候选结果时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。