用途:在新项目启动、确定新仓库初期构成时使用,用于制定开发基线与仓库规则,包括 devcontainer、mise 工具链、前端标准工具链、pnpm 供应链对策、secret scan、AI 代理编辑后的 lint/fmt 自动执行、push 前全测试质量门禁等。
入口流程:未完成入口流程且用户未批准规则适用前,不得创建 devcontainer、脚手架或添加配置文件;入口流程中的规划资料编写属于禁止脚手架之例外。流程依次为:创建 issue;暂拟项目概要(基于提示与合理默认,未明项标为“待确认”);创建含规则适用表、待确认项与推荐理由的规划资料;将已确认资料链接放入 issue 并先提示用户;等待用户判断回复;全部规则确定适用/不适用后进入阶段 4(脚手架)。阶段 1 合理默认:devcontainer 默认不适用,前端有无未记载则待确认,CI 未记载按 GitHub Actions、runner 按 ubuntu-latest,mise 中心运用、gitleaks、pre-commit/pre-push 原则推荐。阶段 2 全量扫描规则并标记适用/不适用/待确认,正本为规划资料而非聊天。阶段 3 以资料与 issue 回复为主要确认手段,AskQuestion 仅限资料提示后且资料本文无法解决的阻塞,禁止在资料提示前或同轮使用。阶段 4 仅对已批准“适用”行按参照文件实现,不适用项不创建对应文件,完成前按 checklist.md 核对并简短保留已批准适用表。
规则与限制:规则含 devcontainer(可选默认不适用)、mise 中心运用、user settings 确认、样本文件起点、gitleaks、self-hosted runner CI、pre-commit/pre-push、push 前全测试、pnpm 固定与供应链、Vite+、Svelte/SvelteKit、kiso.css、Oxlint/Oxfmt、lint/format 命令、编辑后 hooks、Tab 补全后 hook、mise 日常 task 等,各有条件与参照文件。前端缺失则前端类规则不适用,lint/format 与编辑后 hooks 按后端语言选型。具体命令、配置内容与文件细节以 references 与 checklist.md 为准,资料未提供的部分暂未提供。