用途
cognitive-register 用于自动化地将新的 cognitive 注册到 SynapSync Registry 中，确保每一条记录都严格遵循既定的目录结构、命名约定、manifest 架构和注册表索引格式，对不一致零容忍。
主要能力
- 识别触发词：支持西班牙语与英语的触发模式，如 GUARDA、REGISTRA、AGREGA、SAVE、REGISTER、ADD，后接名称与类型（SKILL、AGENT、PROMPT、WORKFLOW、TOOL）。
- 解析请求：提取 cognitive 名称（转为 kebab-case）、类型、内容与分类。
- 唯一性校验：读取 registry.json，检查同名 cognitive 是否已存在，若重复则提示用户选择更新版本、改名或取消。
- 创建目录结构：按 cognitives/{type}s/{category}/{name}/ 模式创建目录。
- 写入内容文件：根据类型写入对应文件（skill → SKILL.md，agent → {name}.md，prompt → PROMPT.md，workflow → WORKFLOW.yaml，tool → TOOL.md）。
- 生成 manifest.json：包含 schema、名称、类型、版本、描述、作者、许可证、分类、标签、提供方、文件、仓库、主页、创建与更新时间等字段。
- 更新 registry.json：递增 totalCognitives，追加新条目，并保持描述、标签、提供方与 manifest 一致。
- 注册后确认：报告创建的文件路径、更新后的注册表计数及 cognitive 的完整路径。
使用方式
用户通过触发词发起注册请求，例如“GUARDA project-planner SKILL”或“REGISTER deploy-automator AGENT”，并提供 cognitive 内容。若内容未提供，技能会向用户索取。技能按以下流程执行：解析请求 → 校验唯一性 → 创建目录 → 写入内容文件 → 创建 manifest.json → 更新 registry.json → 确认。
注册过程中遵循若干关键模式：写入前先读取 registry.json；从内容 frontmatter 提取描述时移除 Trigger 部分并截断至 100 字符；根据类型、主题、分类、动作动词和技术推断标签；默认支持所有提供方，仅在内容使用特定提供方语法时限制；所有产物（内容文件、manifest.json、registry.json）在单次操作中原子化创建或更新，避免注册表处于部分状态。
适用场景
- 用户希望将新的技能、智能体、提示词、工作流或工具登记到 SynapSync Registry。
- 用户提供 cognitive 内容并要求保存或注册。
- 需要确保注册条目符合统一结构与命名规范。
- 与其他技能配合使用，例如先用 skill-creator 生成 SKILL.md 内容，再用本技能注册；注册后可用 feature-branch-manager 提交更改并创建 PR。
限制
- 无自动化验证 CI：验证在注册时由 AI 执行，而非 CI 流水线。
- 无版本递增：目前新注册的 cognitive 固定为 1.0.0，版本更新需手动干预。
- 无依赖解析：不检查内容中引用的技能或智能体是否真实存在。
- 单一注册表：仅管理 synapse-registry，不发布到外部注册表。
有效分类与提供方
有效分类包括：general、frontend、backend、database、devops、security、testing、analytics、automation、integrations、planning。若无法明确归类，默认使用 general。
有效提供方包括：claude、openai、cursor、windsurf、copilot、gemini、codex。默认支持所有提供方，除非 cognitive 为特定提供方专用。
命名规范
名称需转为小写、空格替换为连字符、移除除连字符外的特殊字符。推荐模式包括 {technology}、{tech}-{feature}、{framework}-{component}、{action}-{target}、{domain}-{function}。避免使用 utils、helpers、common、misc、project1、test、new-skill 等名称。
版本历史
1.0（2026-01-28）：初始版本，包含所有 cognitive 类型的完整注册工作流。