project-init

Skill: Project Init

初始化一个遵循 OpenLogos 方法论的项目结构，生成配置文件、AI 指令文件和标准目录。

触发条件

• 用户要求创建新项目或初始化项目结构
• 用户提到 "openlogos init" 或 "初始化项目"
• 当前目录下没有 logos/logos.config.json

核心能力

1. 创建 logos/ 目录及其标准子结构
2. 生成 logos/logos.config.json 配置文件
3. 生成 logos/logos-project.yaml AI 协作索引
4. 生成 AGENTS.md / CLAUDE.md AI 指令文件（根目录）
5. 创建 logos/changes/ 变更管理目录

执行步骤

Step 1: 收集项目信息

向用户确认以下信息：

• 项目名称：用于 logos/logos.config.json 的 name 字段
• 项目描述：一句话描述
• 技术栈：主框架、语言、数据库、部署平台
• 文档模块：除默认的 prd/api/scenario/database 外，是否需要额外模块

如果用户没有提供，使用合理的默认值。

Step 2: 创建目录结构

project-root/
└── logos/
    ├── resources/
    │   ├── prd/
    │   │   ├── 1-product-requirements/
    │   │   ├── 2-product-design/
    │   │   │   ├── 1-feature-specs/
    │   │   │   └── 2-page-design/
    │   │   └── 3-technical-plan/
    │   │       ├── 1-architecture/
    │   │       └── 2-scenario-implementation/
    │   ├── api/
    │   ├── database/
    │   └── scenario/
    └── changes/

Step 3: 生成 logos/logos.config.json

{
  "name": "{项目名称}",
  "description": "{项目描述}",
  "documents": {
    "prd": {
      "label": { "en": "Product Docs", "zh": "产品文档" },
      "path": "./resources/prd",
      "pattern": "**/*.{md,html,htm,pdf}"
    },
    "api": {
      "label": { "en": "API Docs", "zh": "API 文档" },
      "path": "./resources/api",
      "pattern": "**/*.{yaml,yml,json}"
    },
    "scenario": {
      "label": { "en": "Scenarios", "zh": "业务场景" },
      "path": "./resources/scenario",
      "pattern": "**/*.json"
    },
    "database": {
      "label": { "en": "Database", "zh": "数据库" },
      "path": "./resources/database",
      "pattern": "**/*.sql"
    }
  }
}

path 字段相对于 logos.config.json 自身所在目录（即 logos/），因此 ./resources/prd 指向 logos/resources/prd。

Step 4: 生成 logos/logos-project.yaml

project:
  name: "{项目名称}"
  description: "{项目描述}"
  methodology: "OpenLogos"

tech_stack:
  framework: "{用户提供的框架}"
  language: "{用户提供的语言}"
  # ... 根据用户提供的信息填充

resource_index: []
  # 初始为空，随着文档产出逐步添加

conventions:
  - "遵循 OpenLogos 三层推进模型（Why → What → How）"
  - "每次变更必须先创建 logos/changes/ 变更提案"