Communitygithub.com

RWS — 原始资源、Wiki 与 Schema

基于安德烈·卡帕西“LLM Wiki”模式,由 LLM 维护的持久知识库架构。适用于包含 raw/、wiki/ 或 schema/ 文件夹的项目,或需要审计代码库、记录知识、规划功能 (grill)、规划 UI/UX (grill-design) 或执行 /<scope>:<action> 格式命令的场景。

RWS — 原始资源、Wiki 与 Schema 是什么?

RWS 技能实现了一个由 LLM 驱动的持久知识库架构,灵感来自 Andrej Karpathy 的“LLM Wiki”模式。它将知识分为三层:raw/(用户所有,不可变)、wiki/(代理编写和维护的连接图)和 schema/(用户与代理共同演进的项目约定与工作流)。该技能自动检测项目状态,引导设置新项目或现有项目,并强制遵守严格协议,如先查询 wiki、每次变更更新索引和日志、schema 变更需显式批准,以及 wiki 条目必须引用 raw 来源。它支持各种命令(/setup-brown-space、/grill、/ticket:new 等),为开发者提供了一个结构化的、基于 LLM 的知识管理框架,可跨 Cursor、Codex 等平台工作。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add victor-lis-bronzo/rws-skill

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

RWS — 原始资源、Wiki 与 Schema 是做什么的?

通用指令。如果此技能已激活,请在执行任何操作前阅读本文件全部内容, 并在需要决定下一步行动时查阅代理路由器。

1. 模型概述(30秒)

层文件夹(用户项目中)所有者黄金法则
原始资源 (Raw Sources)raw/用户不可变。 代理仅读取并引用,从不编辑。
Wikiwiki/代理代理负责编写、连接并保持一切一致。
Schemaschema/用户 + 代理约定与工作流。需经用户批准共同演进。

完整详情:core/architecture.md。

2. 强制性协议(每次会话)

  1. 检测项目状态:
    • 不存在 raw/、wiki/、schema/ → 建议 /setup-green-space(新项目)或 /setup-brown-space(现有代码库)。
    • 存在 → 读取 schema/schema.md,然后 wiki/index.md,最后读取 wiki/log.md 的最后5条记录。
  2. 使用agent-router.md路由用户意图。
  3. 优先从 wiki 回答用户提问(index → 页面 → raw 以确认)。使用 [[wikilinks]] 引用页面,使用 raw/<文件>#<章节> 引用来源。
  4. 对 wiki 的每次修改都需更新 wiki/index.md 并在 wiki/log.md 中添加一条记录。
  5. 对 schema 的每次修改都需要用户明确批准。
  6. 好的回答变为页面:相关的分析、比较和综合内容会通过 /wiki:add 提供给用户。

3. 命令

语法:/<作用域>:<操作> — 作用域 raw-source | wiki | schema | ticket,操作 add | remove | increment | new | tdd | code | review。

命令工作流
/rws:summarycore/agent-router.md — 每种情况应使用的技能
/setup-brown-spaceskills/setup-brown-space
/setup-green-spaceskills/setup-green-space
/grill (/grill-me)skills/grill
/grill-designskills/grill-design
/ticket:new · :addnew · add
/ticket:tdd · :code · :reviewtdd · code · review
/implementskills/implement — 实现/路线图协调器
/raw-source:add · :remove · :incrementadd · remove · increment
/wiki:add · :remove · :incrementadd · remove · increment
/schema:add · :remove · :incrementadd · remove · increment
/rws:lintnode <skill>/bin/lint-rws.js <项目根目录> + core/lifecycle.md

4. 参考资料

5. 禁止事项

  • ❌ 编辑或删除 raw/ 中的文件(除非通过 /raw-source:remove 经批准后移动到 raw/_archive/)。
  • ❌ 创建 wiki 页面但未在 index.md 和 log.md 中注册。
  • ❌ 未经明确批准更改 schema/。
  • ❌ 陈述无出处的事实:wiki 中所有非琐碎的陈述都必须指向 raw/ 或其他页面。

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

相关技能