RWS — 原始资源、Wiki 与 Schema 是做什么的?
通用指令。如果此技能已激活,请在执行任何操作前阅读本文件全部内容, 并在需要决定下一步行动时查阅代理路由器。
1. 模型概述(30秒)
| 层 | 文件夹(用户项目中) | 所有者 | 黄金法则 |
|---|---|---|---|
| 原始资源 (Raw Sources) | raw/ | 用户 | 不可变。 代理仅读取并引用,从不编辑。 |
| Wiki | wiki/ | 代理 | 代理负责编写、连接并保持一切一致。 |
| Schema | schema/ | 用户 + 代理 | 约定与工作流。需经用户批准共同演进。 |
完整详情:core/architecture.md。
2. 强制性协议(每次会话)
- 检测项目状态:
- 不存在
raw/、wiki/、schema/→ 建议/setup-green-space(新项目)或/setup-brown-space(现有代码库)。 - 存在 → 读取
schema/schema.md,然后wiki/index.md,最后读取wiki/log.md的最后5条记录。
- 不存在
- 使用agent-router.md路由用户意图。
- 优先从 wiki 回答用户提问(index → 页面 → raw 以确认)。使用
[[wikilinks]]引用页面,使用raw/<文件>#<章节>引用来源。 - 对 wiki 的每次修改都需更新
wiki/index.md并在wiki/log.md中添加一条记录。 - 对 schema 的每次修改都需要用户明确批准。
- 好的回答变为页面:相关的分析、比较和综合内容会通过
/wiki:add提供给用户。
3. 命令
语法:/<作用域>:<操作> — 作用域 raw-source | wiki | schema | ticket,操作 add | remove | increment | new | tdd | code | review。
| 命令 | 工作流 |
|---|---|
/rws:summary | core/agent-router.md — 每种情况应使用的技能 |
/setup-brown-space | skills/setup-brown-space |
/setup-green-space | skills/setup-green-space |
/grill (/grill-me) | skills/grill |
/grill-design | skills/grill-design |
/ticket:new · :add | new · add |
/ticket:tdd · :code · :review | tdd · code · review |
/implement | skills/implement — 实现/路线图协调器 |
/raw-source:add · :remove · :increment | add · remove · increment |
/wiki:add · :remove · :increment | add · remove · increment |
/schema:add · :remove · :increment | add · remove · increment |
/rws:lint | node <skill>/bin/lint-rws.js <项目根目录> + core/lifecycle.md |
4. 参考资料
- core/architecture.md — 三层架构及其工作原理
- core/agent-router.md — 决策概要
- core/conventions.md — 命名、前置元数据、wikilinks
- core/index-and-log.md —
index.md和log.md的格式 - core/lifecycle.md — 注入、查询、检查、复合
- core/ui-patterns-catalog.md — UI 模式与参考应用
- templates/ — 页面模板
5. 禁止事项
- ❌ 编辑或删除
raw/中的文件(除非通过/raw-source:remove经批准后移动到raw/_archive/)。 - ❌ 创建 wiki 页面但未在
index.md和log.md中注册。 - ❌ 未经明确批准更改
schema/。 - ❌ 陈述无出处的事实:wiki 中所有非琐碎的陈述都必须指向
raw/或其他页面。