技能 Core

项目初始化

项目脚手架——为新项目或现有项目创建 AGENTS.md、documentation/ 和 datarim/。

概述

当你运行 /dr-init create project "Name" 时,Project Init 会搭建标准化的项目结构。它会创建包含人工实体通用法则与 Datarim 流水线集成的 AGENTS.md、文档存根、临时工作目录以及 Datarim 工作流状态——新项目开始使用该框架所需的一切。

创建的内容

  • AGENTS.md——基于模板生成,包含人工实体通用法则、Datarim 流水线参考、项目特定的占位符
  • documentation/——tutorials/、how-to/、reference/、explanation/(Diátaxis 的四个类别)
  • documentation/ephemeral/——plans/、research/、reviews/(临时工作目录)
  • datarim/——backlog.md、tasks.md、activeContext.md(工作流状态)
  • documentation/archive/——用于存放已完成任务的归档
  • .gitignore——针对检测到的技术栈的标准配置,并排除 datarim/

意图检测

当 /dr-init 在用户提示中检测到项目创建关键词时,该技能会被激活:"create project"、"new project"、"init project"、"scaffold project"(英文)或 "создай проект"、"новый проект"、"инициализируй проект"(俄文);"update project structure" 或 "re-scaffold" 会以更新模式重新运行它。没有这些关键词时,/dr-init 遵循标准任务流程——完全向后兼容。

技术栈集成

该技能会加载 tech-stack.md,根据项目描述自动检测合适的技术栈。这决定了 .gitignore 的内容、AGENTS.md 的构建命令以及建议的依赖项。对于纯文档项目,会跳过技术栈检测。

保密感知脚手架

当任务简报带有 secrecy: <domain> 标注或秘密核心关键词(例如 "proprietary algorithm" 或 "encoding scheme")时,脚手架从第一次提交起就不包含机制信息:参考架构存根基于脱敏变体编写,公开文档界面或任何 README 中都不会描述秘密机制,并且 AGENTS.md 会获得一个 ## Secrecy 块,在脚手架生成时带有 grep 门禁。没有该信号时,脚手架保持不变。

幂等性

可安全地在现有项目上运行。每个文件和目录在创建前都会检查——现有文件绝不会被覆盖,只会创建缺失的文件。脚手架生成后的报告会列出已创建和已跳过的内容。

使用时机

当检测到项目创建意图时,由规划器代理在 /dr-init 第 0 步加载。脚手架完成后,命令即退出——不会继续进入任务创建流程。

4.2 中的报告连接

共享的 Human Outcome Reporting 契约将任务需求连接到计划、结果、验证和证据。/dr-explain 是只读的解释路径。发布模板与图谱使这些链接可被发现;项目脚手架现在使用 AGENTS.md 模板。