---
name: configure
description: "Interactively configure the Cortex Agent for a new project."
type: procedure
applicable_to:
  - all
inputs: []
outputs: []
linked_skills: []
linked_rules: []
linked_workflows: []
owner: Kucell
last_verified: 2026-08-06
status: stable
---

# 🚀 Agent 配置工作流 (/configure)

你好！我是 Cortex Agent。为了更好地协助你，我需要了解一下你的项目。请回答以下几个问题，我将为你自动生成初始配置文件。

## 1. 简要介绍 (Project Briefing)

**请用几句话描述这个项目的核心目标是什么？它的主要用户是谁？**

> (请在这里填写你的回答)

## 2. 技术栈定义 (Tech Stack)

**这个项目主要使用哪些编程语言、框架和关键库？** (例如: TypeScript, React, Node.js, Express, PostgreSQL)

> (请在这里填写你的回答)

## 3. 主力编程语言 (Primary Language)

**请选择一个或多个主力编程语言，以便我加载对应的语言规范规则：**

- [ ] TypeScript / JavaScript
- [ ] Python
- [ ] Go
- [ ] Java
- [ ] Swift
- [ ] 其他（请说明）

> (请勾选或填写)

## 4. 架构原则 (Architecture Design)

**项目有无遵循特定的架构模式？(例如：分层架构、六边形架构、微服务) 或者，有哪些你希望我遵守的核心设计原则？** (例如: "保持模块解耦", "服务必须是无状态的")

> (请在这里填写你的回答)

---
## 🤖 我的操作 (My Actions)

收到你的回答后，我将执行以下操作：

1. **更新 `task-progress.md`**：将你的项目目标填充到项目路线图中。
2. **更新 `tech-stack.md`**：将你定义的技术栈写入规则文件。
3. **激活语言规则**：根据第 3 步选择，读取对应的语言规则文件内容，追加到 `.agent/rules/tech-stack.md` 末尾：

   | 选择 | 语言规则文件 |
   |------|-------------|
   | TypeScript / JavaScript | `.agent/rules/languages/typescript.md` |
   | Python | `.agent/rules/languages/python.md` |
   | Go | `.agent/rules/languages/golang.md` |
   | Java | `.agent/rules/languages/java.md` |
   | Swift | `.agent/rules/languages/swift.md` |

   操作：读取对应文件的完整内容，在 `tech-stack.md` 末尾追加分隔线和内容：
   ```
   ---
   <!-- 以下由 /configure 自动注入：{语言} 语言规范 -->
   {语言规则文件内容}
   ```

4. **更新 `architecture-design.md`**：将你的架构原则写入规则文件。

5. **知识层合规校验**：运行 OKF V0.2 校验与知识层 lint，确保 `.agent/` 三层 frontmatter 合规：
   ```bash
   node .agent/scripts/validate-frontmatter.js
   node .agent/skills/knowledge-lint/scripts/index.js
   ```
   若 `validate-frontmatter.js` 报 `V-FM-002`（必填字段缺失），请补全对应字段后再继续；`knowledge-lint` 的 `R-LINT-007/008` 仅为 warning，可后续增量修复。

完成后，我就是你项目的专属 AI 工程师了！让我们开始吧。