SuperAPI AI 工具集

ia-compound-docs

写作与研究

查看项目

更新于 10-15 22:17

技能介绍

用途:ia-compound-docs 用于记录已解决的问题,为 /ia-compound 提供流程知识,适合在问题修复后撰写经验教训、沉淀团队可复用的解决方案。

主要能力:采用单文件架构,每个问题一个 Markdown 文件,放在按症状分类的目录中,例如 docs/solutions/performance-issues/n-plus-one-briefs.md,文件使用 YAML frontmatter 保存元数据。它遵循 7 步文档捕获流程:检测确认(在“that worked”“it's fixed”等表述后自动触发,跳过琐碎修复)、收集上下文(提取模块、症状、排查尝试、根因、解决方案、预防措施,关键上下文缺失则阻断)、检查已有文档(搜索 docs/solutions/ 中的相似问题,并提供新建带交叉引用、更新已有文档等选项)、生成文件名(格式为 [sanitized-symptom]-[module]-[YYYYMMDD].md)、校验 YAML(运行 validate-frontmatter.sh,不通过则修复并重跑)、创建文档(按 resolution-template.md 写入 docs/solutions/[category]/[filename].md)、交叉引用(关联相关问题,识别 3 个以上相似问题的关键模式)。

使用方式:文档创建成功后展示决策菜单并等待用户响应,选项包括继续工作流、加入必读、关联相关问题、加入已有技能、创建新技能、查看文档等。

成功标准:YAML frontmatter 通过校验、文件写入指定路径、枚举值与 schema 一致、解决方案部分包含代码示例、发现相关问题则添加交叉引用、向用户展示决策菜单并确认操作。

限制:资料未提供安装方式、收费、平台支持等信息;关键上下文缺失时会阻断流程,琐碎修复会被跳过。