2026年8月15日

project-init 技能 — 搭建一致的项目结构

当 /dr-init 检测到项目创建意图时,Datarim 的 project-init 技能如何创建 AGENTS.md、按 Diátaxis 拆分的文档以及工作流状态目录。

借助 AI 助手启动新项目,通常意味着助手会临时决定项目结构。两个项目之后,没有两个项目看起来是一样的。project-init 技能将这一设置标准化:当 /dr-init 检测到项目创建意图时,它会运行,并且每次都生成相同的骨架。

何时激活

当输入包含“create project”、“new project”、“scaffold project”等关键词或其俄语对应词时,该技能会从 /dr-init 加载。如果没有这些信号,/dr-init 会改为遵循标准任务流程。如果提示中已经提供了足够的上下文,该技能会直接提取项目名称、描述和类型,而无需询问。

它创建的结构

该技能会构建一个项目根目录,其中包含根据模板填充的 AGENTS.md、与检测到的技术栈匹配的 .gitignore,以及一个按四个 Diátaxis 类别拆分的 documentation/ 目录树——tutorials/、how-to/、reference/ 和 explanation/——每个类别都预置一个 README。它还会创建用于临时工作材料的 documentation/ephemeral/,以及用于工作流状态的 datarim/ 目录。每个文件都来自 ${DATARIM_RUNTIME}/templates/ 下的版本化模板。

幂等性规则

该技能从不覆盖现有文件。在已经具有某些结构的项目中运行时——例如,将旧代码库升级到标准布局——它只创建缺失的内容,并报告所有跳过的内容。当操作员说“update project structure”时,同样的逻辑也适用:该技能会填补空白,而不触碰已经存在的内容。

它不做什么

该技能不安装依赖、不生成源代码,也不运行 CI 设置。它也不会自动创建初始 git 提交——操作员会先审查搭建出的文件。如果 .git/ 不存在,则会初始化 Git,并将 datarim/ 添加到 .gitignore,以便工作流状态不被跟踪。请参阅 project-init 参考,或阅读 Datarim 是什么以了解更广泛的背景。