命令 Pipeline

/dr-init

初始化新任务、从待办列表恢复,或搭建新项目

概述

/dr-init 是每个 Datarim 工作流的入口。它支持两种模式:任务模式(创建或恢复任务)和项目模式(搭建新项目)。模式会根据你的提示自动检测——无需任何标志。

在任务模式下,它会在首次运行时创建 datarim/ 目录,分配复杂度级别(L1 到 L4),生成唯一任务 ID,并将你路由到正确的下一阶段。如果存在待办列表,它可以拉取待处理项,而不是从头开始。

在项目模式下,它会搭建 AGENTS.md、documentation/ 下的四个 Diátaxis 类别、documentation/ephemeral/、Datarim 工作流状态以及 .gitignore。技术栈通过 tech-stack.md 自动检测。

用法

# 任务模式(默认)
/dr-init "添加深色模式切换"
/dr-init 从待办列表中选择
/dr-init <TASK-ID>

# 项目模式(根据关键词自动检测)
/dr-init 创建项目 "我的 API 服务"
/dr-init 为任务管理应用新建项目
/dr-init создай проект "Мой сервис"

功能说明

  1. 解析 git 根目录,并在不存在时创建 datarim/(唯一允许执行此操作的命令)。
  2. 首次运行时,搭建 backlog.md、tasks.md、activeContext.md 和 documentation/archive/。通过克隆本地的 .git/info/exclude 将 datarim/ 排除在 git 之外,绝不通过编辑共享的 .gitignore 来实现。
  3. 检查待办列表中的待处理项。如果给出了待办项 ID 或“从待办列表中选择”,则选择该项并保留其现有 ID。
  4. 分析请求,确定复杂度(L1-L4),并使用统一任务编号分配任务 ID(优先项目前缀,其次区域前缀,TASK 作为回退)。
  5. PRD 豁免检查(仅限 3-4 级)— 如果任务没有 PRD,则提示:先运行 /dr-prd,或说明豁免原因(记录在 tasks.md 中)。
  6. 对于 L3-L4 任务,提出子任务分解建议,并提供将子任务添加到待办列表的选项。
  7. 创建或更新 datarim/tasks.md。将新任务追加到 datarim/activeContext.md 中的 ## Active Tasks 下——不会移除现有的活动任务。如果文件使用旧版单任务格式,则先转换为 ## Active Tasks 列表。
  8. 步骤 2.5b — 主题重叠提示(v2.7.0+):一项非阻塞检查,将新任务描述与待办列表中的待处理项进行比较,并显示任何共享 ≥2 个关键词词干的项。当 python3 不存在或待办列表没有待处理项时静默跳过。支持 RU + EN 分词。操作员在提交新任务 ID 之前选择重复 / 细化范围 / 正交。

参数

可选。自由文本任务描述、待办项 ID(例如 <TASK-ID>),或短语“从待办列表中选择”以交互方式浏览待处理项。

输出

创建或更新:datarim/tasks.md、datarim/activeContext.md、datarim/backlog.md(如果从待办列表中选择)。

多任务支持

多个任务可以同时处于活动状态。每次 /dr-init 都会追加到活动任务列表,而不是替换它。使用 /dr-status 查看所有活动任务,使用 /dr-next 选择要恢复的任务。

示例会话

$ claude
> /dr-init "实现用户认证"

正在分析任务...
复杂度:3 级(复杂功能,5-15 个文件)
任务 ID:<TASK-ID>

PRD 豁免检查:
  未找到此 L3 任务的 PRD。
  选项:(a) 先运行 /dr-prd,(b) 说明豁免原因
  > b "范围已从之前项目中充分理解"
  PRD 已豁免:"范围已从之前项目中充分理解"

已在 datarim/tasks.md 中创建条目
已追加到 datarim/activeContext.md 中的活动任务

此任务有 3 个可识别的子任务:
  1. OAuth 提供商集成
  2. 会话管理
  3. 基于角色的访问控制
将它们添加到待办列表以进行独立跟踪?(y/n)

后续步骤:
  /dr-plan 用于实现计划

项目搭建(v1.14.0)

当 /dr-init 检测到项目创建关键词(“创建项目”、“新建项目”、“搭建项目”或俄语对应词)时,它会进入项目模式:

  1. 加载 project-init 技能
  2. 收集项目信息(名称、描述、类型)
  3. 通过 tech-stack.md 自动检测技术栈
  4. 创建:AGENTS.md、documentation/{tutorials,how-to,reference,explanation}/、documentation/ephemeral/、datarim/ 状态以及 .gitignore
  5. 报告已创建和已跳过的内容

幂等——可安全地在现有项目上运行。现有文件绝不会被覆盖;只创建缺失的文件。使用“更新项目结构”向现有项目添加缺失文件。

流水线位置

第一阶段。始终启动流水线。在任务模式下,根据复杂度进行路由:L1 直接进入 /dr-do,L2 进入 /dr-plan,L3-L4 进入 /dr-prd,除非 PRD 被豁免。在项目模式下,搭建完成后退出。

相关命令

报告结果

在面向人员的更新或结果之前,应用人类成果报告。说明用户可见的结果、原始条件、检查和证据,以及未解决的限制。阶段结果并不意味着整个任务已完成。保持精确的协议和技术记录完整。若要在不继续工作的情况下再次解释,请使用 /dr-explain。