1
0
Files
Skill/openspec/specs/kb-project-management/spec.md

1.5 KiB
Raw Blame History

ADDED Requirements

Requirement: 初始化知识项目目录结构

系统 SHALL 在 CWD 下创建以指定名称命名的子目录,并在其中生成以下固定结构:

  • project.md:初始内容包含项目名称标题、空的概述/关键信息段落、空的文件索引表和空的更新记录
  • manifest.json:初始内容包含项目名称、创建时间、空的 files 数组
  • parsed/ 目录
  • sources/ 目录
  • archive/ 目录

Scenario: 成功初始化新项目

  • WHEN 用户执行 /lyxy-kb-init my-project,且 CWD 下不存在 my-project 目录
  • THEN 系统创建 my-project/ 目录及完整子结构project.md、manifest.json、parsed/、sources/、archive/),并提示用户将文档放入 sources/ 目录

Scenario: 目标目录已存在

  • WHEN 用户执行 /lyxy-kb-init my-project,且 CWD 下已存在 my-project 目录
  • THEN 系统 SHALL 提示用户该目录已存在,不覆盖任何现有内容

Requirement: 项目目录结构规范

知识项目 SHALL 遵循固定的目录结构:project.mdmanifest.jsonparsed/sources/archive/。所有 command 和 skill 操作 SHALL 基于此结构进行,不在结构外创建额外文件或目录。

Scenario: 验证项目结构完整性

  • WHEN 任何 commandingest/rebuild/ask在指定项目目录上执行
  • THEN 系统 SHALL 先检查目录结构是否完整(包含 project.md、manifest.json、parsed/、sources/、archive/),若不完整则提示用户先执行 init