Farris Vue AI Coding 脚手架

这是一个为既有 Farris Vue 项目安装 AI Coding 开发能力的能力包。模型会把本仓库中的 Skills、Rules 和当前 IDE 的原生配置接入目标项目；MCP 则安装为开发者机器上的共享版本化运行时，并在目标项目写入精确版本/哈希的项目级配置。安装会保留目标项目已有配置与未提交修改，并给出验证结果。

默认初始化流程只负责初始化开发环境：不自动创建业务工程、不实现业务需求，也不修改与本次安装无关的内容。需要创建标准前端 workspace 时，必须由开发者确认后使用 workspace-bootstrap 技能。

@farris/bootstrap CLI 的目标架构、根 Manifest、实施阶段、测试矩阵和验收标准见 Bootstrap CLI 设计与验收方案。

快速开始（CLI，推荐）

发布后通过 CLI 完成确定性的初始化；模型负责从对话中收集参数（目标项目、宿主 IDE 等），然后调用 CLI：

# 生成变更计划（不写任何文件）
npx @farris/bootstrap init --target <目标项目> --host claude-code,opencode,trae,codebuddy

# 确认后应用（--plan-id 与计划输出一致时才会执行）
npx @farris/bootstrap init --target <目标项目> --host <ids> --yes --plan-id <planId>

# 其他命令
npx @farris/bootstrap status|update|repair|verify|uninstall --target <目标项目>
npx @farris/bootstrap doctor

所有命令输出机器可读的 JSON 信封（--json 仅输出 JSON）。参数细节见 npx @farris/bootstrap --help 与设计文档。

快速开始（自然语言 fallback）

适用于无法使用 CLI 的场景（网络受限、npx 不可用等）。将本仓库放在模型可读取的位置，然后把下面的内容发送给模型：

请按照此脚手架根 README，为目标项目初始化 AI Coding 开发环境。

目标项目：<绝对路径、相对当前工作目录的路径，或"当前工作区">
IDE/智能体：<可选；不填写时自动识别>

先只读盘点目标项目和现有 AI Coding 配置，展示变更计划；确认安全后，安装仓库中的全部 Skills 和 Rules，并检查项目宪法状态。MCP 不在 fallback 范围内，提示用户改用 `npx @farris/bootstrap` 完成 MCP 安装。仅为 `skills/farris-vue/` 下的 Skills 创建当前 IDE 支持的 commands/slash wrapper；其余 Skills 只按 IDE 原生机制安装，不创建 wrapper。Claude Code/OpenCode 使用 `scripts/install-project-rules.mjs --check`、确认后 `--apply`、完成后 `--verify` 生成 Rule Router；TRAE/CodeBuddy 使用各自原生 Rule。已有 `AGENTS.md` 时保留并按需同步；不存在时，先通过 `agent-constitution` 只读评估当前工程是否已形成足够的项目事实。工程事实充分时，询问用户是否初始化；空工程不创建 `AGENTS.md`，只在报告中说明后续初始化时机。安装完成后按"前端工程提示"检查 workspace；需要创建时只提示使用 `workspace-bootstrap`，不自动创建。保留已有配置和未提交修改。完成后执行可行的验证，清理中间产物并输出初始化报告。

安装流程

flowchart LR
    A[指定目标项目] --> B[识别 IDE 与现有配置]
    B --> C[盘点资源并展示变更计划]
    C --> D[安装 Skills、Rules、MCP]
    D --> E{检查项目宪法}
    E -->|已有 AGENTS.md| F[保留并按需同步]
    E -->|工程已形成| G[询问是否初始化]
    E -->|空工程| H[延迟初始化并提示]
    F --> I[验证并输出报告]
    G --> I
    H --> I

| 阶段 | 模型要做什么 | 结果 | | --- | --- | --- | | 盘点 | 确认目标项目、IDE、Git 状态和已有 AI Coding 配置 | 明确可复用项、冲突与风险 | | 计划 | 列出新增、修改、复用和跳过的内容 | 用户可在写入前审阅影响 | | 安装 | 按当前 IDE 的原生机制安装全部 Skills、Rules 和 MCP 配置；仅为 skills/farris-vue/ 下的 Skills 创建 commands/slash wrapper；MCP 运行时安装到开发者机器的共享缓存 | 目标项目获得可发现、可复现的开发能力 | | 宪法 | 通过 agent-constitution 检查现有项目宪法或只读评估创建时机；工程已形成时，经用户确认后创建或同步 | 既有约定得到保留；空工程不产生无价值的 AGENTS.md | | 验证 | 检查资源可发现性、配置有效性和可执行的最低验证 | 输出完成项、待办、冲突和阻塞项 |

写入前必须展示变更计划。覆盖用户内容、写入目标项目外部、安装软件、使用凭证或需要 IDE 信任/授权时，必须先获得用户明确确认。

安装内容

| 资源 | 用途 | | --- | --- | | Skills | Farris Vue 领域开发知识与工作流 | | Rules | 按任务或文件范围生效的工程约束 | | MCP | 模型可调用的知识服务和外部工具 | | IDE Plugin | 将能力映射到当前 IDE 的原生项目级入口 | | 项目宪法 | 由 agent-constitution 维护的项目协作约定 |

Claude Code 和 OpenCode 的任务型 Rule 通过 project-rule-router 按任务、目标路径、项目标识和排除路径按需加载；路径型 Rule 在 Claude Code 中继续使用原生 paths。使用当前 IDE 安装说明中的 install-project-rules.mjs --check/--apply/--verify 完成确定性投影，Router 不承担工程创建、MCP 或项目宪法管理。

目录中的资源就是该场景的完整能力集合。安装时复用相同内容；同名但来源不明或内容不同的文件保留原状并报告冲突，不静默覆盖或改名。

前端工程提示

本脚手架安装完成后，模型应只读检查目标目录是否已有可用的 Farris Vue 前端 workspace。

• 已有 workspace：报告其位置并继续初始化结果，不重复创建。
• 目标目录为空、只有 .git 或只有已安装的 AI Coding 配置：提示使用 workspace-bootstrap 技能创建标准前端 workspace。
• 目录非空但无法识别，或已经是其他前端工程：报告冲突并请用户指定前端目录或接入方式。

workspace-bootstrap 拥有自己的模板和脚本，位于 skills/farris-vue/workspace-bootstrap/。创建前可由技能推荐应用名称、应用编号和应用目录，但三者必须由开发者确认；未经确认不得创建文件或安装依赖。根项目不生成 package name，包管理器固定为 pnpm。

完成标准

初始化报告至少应说明：

• 已安装、已复用、已跳过和冲突的 Skills、Rules、MCP 与配置项；
• Skills 和 Rules 可被当前 IDE 发现或按当前环境完成静态验证；
• MCP 已完成注册及其声明的最低无副作用验证；需要登录、信任或 UI 操作的项明确列为待办；
• 项目宪法的状态（已有、已创建、延迟或用户暂不创建），以及用户内容是否被保留；
• 前端 workspace 的检测状态；如使用 workspace-bootstrap，还要说明应用名称、应用编号、应用目录、创建验证和依赖安装状态；
• 尚未完成的原因和用户需要执行的最短操作。

模型阅读路径

根 README 只提供主线。模型仅在进入相应阶段时继续读取以下文件：

| 需要处理的内容 | 读取位置 | | --- | --- | | 当前 IDE 的安装差异 | plugins/<ide-id>/install.md | | 某个 MCP 的安装、配置和验证 | mcp/<mcp-id>/README.md | | 某个 Skill 的使用与安装信息 | skills/**/SKILL.md | | 某条工程规则 | rules/** 下的对应规则文件 | | 项目宪法 | skills/agent-constitution/agent-constitution/SKILL.md |

不要一次性加载所有能力正文；只读取当前步骤需要的专项文档。目标项目里已有的其他工具或目录属于项目自身内容，除非本次安装直接涉及，否则保持不变。