{"owner":"web-infra-dev","repo":"modern.js","hasSkills":true,"hasMcp":false,"mcpConfig":null,"found":["CLAUDE.md","AGENTS.md"],"skills":{"CLAUDE.md":"# CLAUDE.md\n\n本仓库的 AI Agent 指引统一维护在 [`AGENTS.md`](./AGENTS.md)，请以该文件为准。\n\nClaude Code 会自动加载本文件；这里只做指向，避免两份内容漂移。\n","AGENTS.md":"# AGENTS.md — Modern.js monorepo\n\n> 给在本仓库工作的 AI Agent（Claude Code / Cursor 等）的常驻指引。保持精简：只放命令、约束、路由。详细知识查文档与 llms.txt，复杂流程走 `skills/`。\n\n## 这是什么仓库\n- Modern.js：基于 React 的渐进式 Web 框架（当前主仓为 **v3**）。\n- pnpm + nx monorepo。包的划分见 `pnpm-workspace.yaml`，主要分区：\n  - `packages/solutions/app-tools` — 应用工程方案（高风险区）\n  - `packages/cli/*` — 构建器与 CLI 插件（builder 等，高风险区）\n  - `packages/runtime/*` — 运行时（高风险区）\n  - `packages/server/*` — 服务端 / BFF（高风险区）\n  - `packages/toolkit/*` — 工具库（含 `create` 脚手架）\n  - `packages/document` — 文档站（rspress，产出 llms.txt）\n\n## 常用命令\n- 安装依赖：`pnpm install`\n- 构建单包：`pnpm --filter <pkg> build`\n- 跑测试（按类型分别跑）：\n  - 单测（rstest）：根目录 `pnpm test:ut`；或单包 `pnpm --filter <pkg> test`（包内即 `rstest`）。\n  - 框架集成测试：`pnpm test:framework`（实际在 `tests/` 下跑 rstest 集成用例）。\n  - 构建器（builder）e2e 测试：`pnpm test:builder`（在 `tests/e2e/builder` 下）。\n  - Skill 回归：`node tests/skill/run.mjs`（migrate-to-v3）、`node tests/skill/feature-enable.mjs`（feature-enable）。\n- 代码风格：`biome`（见 `biome.json`），提交前跑 lint。\n- 变更需 changeset：`pnpm change`（影响发布的改动必须加）。\n\n## 禁改区（除非任务明确要求并人工确认）\n- 不手改 `pnpm-lock.yaml`、`dist/`、`node_modules/`、各包 `CHANGELOG.md`。\n- 不改框架运行时语义而不加测试。\n- 不提交 secret / token。\n\n## 查文档（知识检索）\n- API / 配置 / 概念问题优先查 llms.txt：https://modernjs.dev/llms.txt\n- 全文（体积大，按需取片段）：https://modernjs.dev/llms-full.txt\n- 回答须匹配仓库当前版本，勿用更新版本未发布的特性。\n\n## 复杂流程（走 Skills）\n- 两类 Skill 分两处源，别混（详见 `skills/README.md`）：\n  - **用户向**（服务「用 Modern.js 开发应用」的 agent）：唯一手写源是仓库根 `skills/<name>/`（带 SKILL.md 的目录），遵循 Agent Skills 开放标准，用户用标准 `npx skills add web-infra-dev/modern.js --skill <name>` 安装（锁版本加 `#<tag>`）。已落地 `modernjs-migrate-to-v3`、`modernjs-feature-enable`。\n  - **维护者向**（服务「开发 Modern.js 仓库」的 agent）：唯一手写源是 `scripts/skills/<name>/`，**不放在根 `skills/`**（避免被对外 `skills` CLI 默认发现）；`.claude/skills`、`.agents/skills`、`.cursor/skills` 只是 `pnpm sync:skills` 生成的镜像（派生物，已 gitignore）。已落地 `dependency-audit`；规划中（P1+）`modernjs-issue-triage`、`modernjs-pr-review`。\n- Skills 默认不强装、不隐式安装；只在多步骤 + 可验证 + 高频场景才做成 Skill，其余沉淀进本文件或文档。\n\n## AGENTS / llms.txt / Skills 边界（一句话）\n- llms.txt = 知识（厚、自动生成）；AGENTS.md = 约束与路由（薄、常驻）；Skills = 可验证的多步骤流程（带脚本/状态）。\n"},"files":{"CLAUDE.md":"# CLAUDE.md\n\n本仓库的 AI Agent 指引统一维护在 [`AGENTS.md`](./AGENTS.md)，请以该文件为准。\n\nClaude Code 会自动加载本文件；这里只做指向，避免两份内容漂移。\n","AGENTS.md":"# AGENTS.md — Modern.js monorepo\n\n> 给在本仓库工作的 AI Agent（Claude Code / Cursor 等）的常驻指引。保持精简：只放命令、约束、路由。详细知识查文档与 llms.txt，复杂流程走 `skills/`。\n\n## 这是什么仓库\n- Modern.js：基于 React 的渐进式 Web 框架（当前主仓为 **v3**）。\n- pnpm + nx monorepo。包的划分见 `pnpm-workspace.yaml`，主要分区：\n  - `packages/solutions/app-tools` — 应用工程方案（高风险区）\n  - `packages/cli/*` — 构建器与 CLI 插件（builder 等，高风险区）\n  - `packages/runtime/*` — 运行时（高风险区）\n  - `packages/server/*` — 服务端 / BFF（高风险区）\n  - `packages/toolkit/*` — 工具库（含 `create` 脚手架）\n  - `packages/document` — 文档站（rspress，产出 llms.txt）\n\n## 常用命令\n- 安装依赖：`pnpm install`\n- 构建单包：`pnpm --filter <pkg> build`\n- 跑测试（按类型分别跑）：\n  - 单测（rstest）：根目录 `pnpm test:ut`；或单包 `pnpm --filter <pkg> test`（包内即 `rstest`）。\n  - 框架集成测试：`pnpm test:framework`（实际在 `tests/` 下跑 rstest 集成用例）。\n  - 构建器（builder）e2e 测试：`pnpm test:builder`（在 `tests/e2e/builder` 下）。\n  - Skill 回归：`node tests/skill/run.mjs`（migrate-to-v3）、`node tests/skill/feature-enable.mjs`（feature-enable）。\n- 代码风格：`biome`（见 `biome.json`），提交前跑 lint。\n- 变更需 changeset：`pnpm change`（影响发布的改动必须加）。\n\n## 禁改区（除非任务明确要求并人工确认）\n- 不手改 `pnpm-lock.yaml`、`dist/`、`node_modules/`、各包 `CHANGELOG.md`。\n- 不改框架运行时语义而不加测试。\n- 不提交 secret / token。\n\n## 查文档（知识检索）\n- API / 配置 / 概念问题优先查 llms.txt：https://modernjs.dev/llms.txt\n- 全文（体积大，按需取片段）：https://modernjs.dev/llms-full.txt\n- 回答须匹配仓库当前版本，勿用更新版本未发布的特性。\n\n## 复杂流程（走 Skills）\n- 两类 Skill 分两处源，别混（详见 `skills/README.md`）：\n  - **用户向**（服务「用 Modern.js 开发应用」的 agent）：唯一手写源是仓库根 `skills/<name>/`（带 SKILL.md 的目录），遵循 Agent Skills 开放标准，用户用标准 `npx skills add web-infra-dev/modern.js --skill <name>` 安装（锁版本加 `#<tag>`）。已落地 `modernjs-migrate-to-v3`、`modernjs-feature-enable`。\n  - **维护者向**（服务「开发 Modern.js 仓库」的 agent）：唯一手写源是 `scripts/skills/<name>/`，**不放在根 `skills/`**（避免被对外 `skills` CLI 默认发现）；`.claude/skills`、`.agents/skills`、`.cursor/skills` 只是 `pnpm sync:skills` 生成的镜像（派生物，已 gitignore）。已落地 `dependency-audit`；规划中（P1+）`modernjs-issue-triage`、`modernjs-pr-review`。\n- Skills 默认不强装、不隐式安装；只在多步骤 + 可验证 + 高频场景才做成 Skill，其余沉淀进本文件或文档。\n\n## AGENTS / llms.txt / Skills 边界（一句话）\n- llms.txt = 知识（厚、自动生成）；AGENTS.md = 约束与路由（薄、常驻）；Skills = 可验证的多步骤流程（带脚本/状态）。\n"},"items":[{"name":"CLAUDE.md","path":"CLAUDE.md","title":"CLAUDE.md","content":"# CLAUDE.md\n\n本仓库的 AI Agent 指引统一维护在 [`AGENTS.md`](./AGENTS.md)，请以该文件为准。\n\nClaude Code 会自动加载本文件；这里只做指向，避免两份内容漂移。\n","category":"root","tokens":28},{"name":"AGENTS.md","path":"AGENTS.md","title":"AGENTS.md","content":"# AGENTS.md — Modern.js monorepo\n\n> 给在本仓库工作的 AI Agent（Claude Code / Cursor 等）的常驻指引。保持精简：只放命令、约束、路由。详细知识查文档与 llms.txt，复杂流程走 `skills/`。\n\n## 这是什么仓库\n- Modern.js：基于 React 的渐进式 Web 框架（当前主仓为 **v3**）。\n- pnpm + nx monorepo。包的划分见 `pnpm-workspace.yaml`，主要分区：\n  - `packages/solutions/app-tools` — 应用工程方案（高风险区）\n  - `packages/cli/*` — 构建器与 CLI 插件（builder 等，高风险区）\n  - `packages/runtime/*` — 运行时（高风险区）\n  - `packages/server/*` — 服务端 / BFF（高风险区）\n  - `packages/toolkit/*` — 工具库（含 `create` 脚手架）\n  - `packages/document` — 文档站（rspress，产出 llms.txt）\n\n## 常用命令\n- 安装依赖：`pnpm install`\n- 构建单包：`pnpm --filter <pkg> build`\n- 跑测试（按类型分别跑）：\n  - 单测（rstest）：根目录 `pnpm test:ut`；或单包 `pnpm --filter <pkg> test`（包内即 `rstest`）。\n  - 框架集成测试：`pnpm test:framework`（实际在 `tests/` 下跑 rstest 集成用例）。\n  - 构建器（builder）e2e 测试：`pnpm test:builder`（在 `tests/e2e/builder` 下）。\n  - Skill 回归：`node tests/skill/run.mjs`（migrate-to-v3）、`node tests/skill/feature-enable.mjs`（feature-enable）。\n- 代码风格：`biome`（见 `biome.json`），提交前跑 lint。\n- 变更需 changeset：`pnpm change`（影响发布的改动必须加）。\n\n## 禁改区（除非任务明确要求并人工确认）\n- 不手改 `pnpm-lock.yaml`、`dist/`、`node_modules/`、各包 `CHANGELOG.md`。\n- 不改框架运行时语义而不加测试。\n- 不提交 secret / token。\n\n## 查文档（知识检索）\n- API / 配置 / 概念问题优先查 llms.txt：https://modernjs.dev/llms.txt\n- 全文（体积大，按需取片段）：https://modernjs.dev/llms-full.txt\n- 回答须匹配仓库当前版本，勿用更新版本未发布的特性。\n\n## 复杂流程（走 Skills）\n- 两类 Skill 分两处源，别混（详见 `skills/README.md`）：\n  - **用户向**（服务「用 Modern.js 开发应用」的 agent）：唯一手写源是仓库根 `skills/<name>/`（带 SKILL.md 的目录），遵循 Agent Skills 开放标准，用户用标准 `npx skills add web-infra-dev/modern.js --skill <name>` 安装（锁版本加 `#<tag>`）。已落地 `modernjs-migrate-to-v3`、`modernjs-feature-enable`。\n  - **维护者向**（服务「开发 Modern.js 仓库」的 agent）：唯一手写源是 `scripts/skills/<name>/`，**不放在根 `skills/`**（避免被对外 `skills` CLI 默认发现）；`.claude/skills`、`.agents/skills`、`.cursor/skills` 只是 `pnpm sync:skills` 生成的镜像（派生物，已 gitignore）。已落地 `dependency-audit`；规划中（P1+）`modernjs-issue-triage`、`modernjs-pr-review`。\n- Skills 默认不强装、不隐式安装；只在多步骤 + 可验证 + 高频场景才做成 Skill，其余沉淀进本文件或文档。\n\n## AGENTS / llms.txt / Skills 边界（一句话）\n- llms.txt = 知识（厚、自动生成）；AGENTS.md = 约束与路由（薄、常驻）；Skills = 可验证的多步骤流程（带脚本/状态）。\n","category":"root","tokens":517}]}