用途
Initializer Agent 是面向自主编码项目的首会话智能体,用于在项目开始时建立基础。它适用于启动新的自主项目、生成功能列表、搭建环境等场景。
主要能力
初始化工作流包含以下步骤:
- 读取项目规格说明:解析需求、识别技术栈、确定项目结构。
- 生成功能列表:创建 100-200 条功能,按类别归类,添加验证步骤,设置初始优先级。
- 创建环境脚本:依赖安装、数据库设置、环境变量、开发服务器。
- 搭建项目:创建目录结构、初始化 package.json/pyproject.toml、创建基础配置、设置测试框架。
- 进行首次提交:git init、添加所有文件、提交信息为 "Initial project setup"。
- 保存状态:写入 feature_list.json、init.sh、claude-progress.txt。
功能类别包括:functional(核心功能)、ui(用户界面)、api(API 端点)、database(数据层)、integration(外部服务)、performance(速度/效率)、security(保护)、accessibility(无障碍合规)、testing(测试覆盖)。
使用方式
初始化项目:
from scripts.initializer import InitializerAgent
agent = InitializerAgent(project_dir)
result = await agent.initialize_project(
spec="Build a task management app with user auth",
tech_stack=["nextjs", "typescript", "prisma"]
)
生成功能列表:
from scripts.feature_generator import generate_features
features = await generate_features(
spec="E-commerce platform with cart and checkout",
count=100 # Generate 100 features
)
输出产物
feature_list.json 示例:
[
{
"id": "auth-001",
"category": "functional",
"description": "User can sign up with email and password",
"steps": [
"Navigate to signup page",
"Enter email address",
"Enter password (min 8 chars)",
"Click submit",
"Verify account created"
],
"passes": false,
"priority": 1
}
]
init.sh 示例:
#!/bin/bash
set -e
# Install dependencies
npm install
# Set up database
npx prisma migrate dev
# Start development server
npm run dev &
claude-progress.txt 示例:
# Session Progress
## Session 1 - 2025-01-15 10:00
### Accomplishments
- Analyzed project specification
- Generated 150 feature requirements
- Created project structure
- Set up development environment
### Next Steps
- Begin implementing auth-001: User signup
集成点
autonomous-session-manager:检测 INIT 会话类型。 context-state-tracker:创建初始状态产物。 coding-agent:从初始化器输出接续工作。
参考与模板
参考文档:references/INITIALIZER-WORKFLOW.md(详细工作流)、references/FEATURE-CATEGORIES.md(类别指南)。
模板:templates/init.sh.template(环境设置)、templates/feature_list.json.template(功能结构)、templates/progress.txt.template(进度文件)。
脚本:scripts/initializer.py(主 InitializerAgent)、scripts/feature_generator.py(功能列表生成)、scripts/environment_setup.py(初始化脚本创建)、scripts/project_scaffold.py(项目搭建)。
限制
关于收费、价格、平台支持范围、具体效果等事实,资料暂未提供。