研究检索只读github未标认证来源可访问许可证需确认审计提醒

cs-rag-architecture-guideline（CS RAG 架构 guideline）

Agent Skill

用于搭建或维护带检索增强的 RAG 工作流，适合让 Agent 处理知识库问答、向量检索、来源引用和事实核查。它可以辅助整理数据接入、Embedding、向量库、召回参数和回答生成流程。使用时需要确认数据来源、更新频率、召回阈值和引用展示方式，避免把未命中的资料或过期内容包装成确定事实。

总安装

264

周安装

GitHub Stars

公开资料未说明

下载量

CodexClaudeCursorGemini CLI

安装说明

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

GitHub

来源数

许可证

unknown

最后核验

2026-05-01

来源状态

来源可访问

安装方式

通过对话安装

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

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

命令行安装

复制命令到本机终端执行。该命令会通过 npx skills 从第三方来源获取 Skill；本站只展示命令，不托管安装包，也不自动执行。

skills.shnpx skills

npx skills add https://github.com/qiao-925/qiao-skills --skill cs-rag-architecture-guideline

简介

cs-rag-architecture-guideline 用于搭建和维护 RAG 工作流，支持知识库问答与向量检索。

提供三层架构约束：前端→业务→基础设施单向依赖，禁止反向与跨层访问。
强制先执行认知检查再设计检查最后合规复核，确保接口契约与依赖注入合理。
适用于数据接入、Embedding、召回参数调优与回答生成流程管理。
需确认数据来源与更新频率，避免将未命中资料包装成确定事实输出。

SKILL.md

CS-RAG 架构总规范

CS-RAG 项目专用架构总规范。已无损合并 architecture-cognition 与 architecture-design 的规则内容，可在原 skill 删除后独立使用。

⚠️ 核心强制要求

统一三层架构约束

前端层 → 业务层 → 基础设施层（单向依赖）
禁止反向依赖：基础设施层不能依赖业务层或前端层
禁止跨层访问：前端层不能直接访问基础设施层
基础设施层不得夹带业务逻辑

认知与设计的组合治理顺序

先执行架构认知检查：层级位置、组件关系、数据流影响
再执行架构设计检查：接口契约、依赖注入、可插拔设计
最后执行合规复核：跨层、反向依赖、循环依赖、兼容性

升级给用户决策的场景

涉及跨层依赖修改
涉及核心组件接口变更（尤其破坏性变更）
涉及数据流向/主路径改变
涉及全局策略、性能、资源消耗或数据一致性风险

AI Agent 行为要求

阶段 A：架构认知（原 `architecture-cognition` 全量迁入）

修改代码前必须回答：

位置识别：属于哪一层？影响哪些组件？有跨层依赖风险？
影响范围：影响哪些数据流？有组件依赖此接口？需更新测试？
架构约束：是否违反三层架构？是否引入循环依赖？

创建新组件时必须明确：

职责定位：属于哪一层？单一职责是什么？与现有组件关系？
接口设计：需要抽象基类/Protocol？需要工厂模式？
依赖管理：依赖哪些组件？是否可依赖注入？是否违反依赖方向？

快速参考（项目上下文）：

层	核心组件	职责
前端层	`frontend/main.py`	用户交互、UI 展示
业务层	`RAGService`, `QueryEngine`	业务逻辑、流程编排
基础设施层	`IndexManager`, `Embedding`, `LLM`	技术实现、无业务逻辑

阶段 B：架构设计（原 `architecture-design` 全量迁入）

设计变更时检查项：

标注影响到的层级与上下游模块
确认无循环依赖
确认无跨层访问

接口设计要求：

以抽象基类或 Protocol 定义契约
新接口默认向后兼容
使用构造函数依赖注入，禁止静态单例

可插拔设计要求：

使用工厂或注册表模式注册新实现
所有可切换组件通过配置项启用

新模块规划时：

每个模块/类仅负责单一领域
命名遵循 src/<layer>/<role>/module.py 结构

阶段 C：合规复核

复核是否引入跨层访问或反向依赖
复核接口变更是否具备兼容策略
复核是否出现循环依赖

判断标准

是否完成“认知 + 设计 + 复核”三阶段检查
是否保持三层依赖方向正确且无循环依赖
是否保留接口兼容性与实现可替换性

无损合并声明

本 skill 已承载两套原始规则的内容级迁移，不是仅链接跳转。
原始 SKILL.md 文本已复制到：

- references/architecture-cognition-skill.md - references/architecture-design-skill.md

原始 references 文本已全量复制到本 skill 的 references/。
详细映射见 references/lossless-merge-routing.md。

删除源 skill 就绪说明

删除 architecture-cognition 与 architecture-design 后，本 skill 仍可独立运行。
删除前后仅路径变化，不会丢失规则内容。

参考资料

references/lossless-merge-routing.md - 无损合并路由与原文映射
references/architecture-cognition-skill.md - 原 architecture-cognition 全文
references/architecture-cognition-system-overview.md - 原认知参考：系统定位
references/architecture-cognition-three-layer-architecture.md - 原认知参考：三层架构
references/architecture-cognition-component-map.md - 原认知参考：组件地图
references/architecture-cognition-data-flow.md - 原认知参考：数据流
references/architecture-design-skill.md - 原 architecture-design 全文
references/architecture-design-layer-guidelines.md - 原设计参考：分层指南
references/architecture-design-module-planning.md - 原设计参考：模块规划
references/architecture-design-interface-design.md - 原设计参考：接口设计

适合场景

研究助手

事实核查

知识库问答

带来源的搜索总结

能力概览

能力 1

组合搜索和大模型调用

能力 2

支持多来源检索和总结

能力 3

强调引用来源和事实核查

能力 4

适合研究型 Agent 流程

安装后应在对应宿主中按原始 README 的触发条件使用；具体调用方式请以来源页面和 README 为准。

平台分布

Codex

34.88%

按下载量换算31

Claude

29.09%

按下载量换算26

Cursor

16.67%

按下载量换算15

Gemini CLI

9.95%

按下载量换算9

安全审计

Gen Agent Trust Hub

通过

Socket

通过

Snyk

可疑

权限和风险

只读

该 Skill 主要提供规则、说明或参考内容，本身偏只读；真正读写文件、联网或执行命令仍取决于宿主 Agent 的任务。

安装前确认

本站仅展示第三方公开信息，不托管安装包，不提供自动安装或运行环境。安装前应自行审查源码、依赖和命令行为。来源安全扫描存在 warning/failed 结果，不能写成本站确认安全。当前只有一个来源，正式发布前建议补源仓库或其他目录站核验。

来源信息

GitHub 仓库

github.com

/qiao-925/qiao-skills

SKILL.md 来源

github.com

/qiao-925/qiao-skills/tree/main/skills/cs-rag-architecture-guideline

skills-sh

skills.sh

/qiao-925/qiao-skills/cs-rag-architecture-guideline

继续浏览同类 Skills

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

上一个 Skill

cs-pw（密码保护）

cs-pw 用于处理浏览器自动化、网页检查和页面信息提取，适合在 OpenClaw 中需要让 Agent 打开页面、读取网页或验证前端流程时使用。可结合来源仓库、安装命令和原始 README 继续核验具体用法。安装前建议确认权限范围、维护状态，以及是否会触发联网、命令执行或文件读写。

下一个 Skill

cs-req（客户要求）

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