用途:init 用于从零开始搭建新项目脚手架,让智能体按你偏好的设置、工具链和仓库规范生成初始结构,而不必反复说明同样的偏好。适用于新建仓库、把简要说明或规格转成第一个可运行骨架。
主要能力:读取 $ARGUMENTS、当前简要说明或规格作为项目描述;加载内置 Python 服务默认配置 references/python-service.md,若存在 ~/.agents/stacks/python-service.md 则以其覆盖内置配置。根据需求推断条件选择:需要持久化时使用 PostgreSQL,需要检索或 RAG 时使用 PostgreSQL 加 pgvector,未暗示持久化则不添加数据库代码。生成最小可运行脚手架,写入 AGENTS.md 记录标准 just 命令和仓库规则,并在完成前运行相关验证。
使用方式:先读取简要说明或规格,推断项目需求;加载 Python 服务参考及用户覆盖配置;在固定核心依赖版本前检查其最新稳定版本,不依赖记忆中的版本。最多一次性提出三个简洁问题,且仅在简要说明或规格中缺失答案时询问:项目名称、创建 GitHub 仓库时的可见性、与栈默认值的偏差。不要询问栈已定义的标准工具选择。若请求不是 Python 服务或 API,应停止并询问明确支持的栈或新的栈参考。
输出与规则:生成标准项目文件、工具配置、最小应用代码、测试,以及告知后续智能体优先使用 just 命令的 AGENTS.md。保持脚手架精简,不建空文件夹、占位功能或推测性依赖;优先标准而非自创;Python 服务使用 FastAPI、pydantic-settings、uv、ruff、pyright、pytest 和 just;需要数据库时默认 PostgreSQL;在 .env.example 中记录每个必需环境变量;脚手架完成后停止,不构建产品功能。
验证:运行 just build、just test、just check;应用启动时无导入或设置错误;不提交密钥。
限制:仅面向 Python 服务或 API,其他栈需显式支持或新参考;不构建产品功能;不添加未暗示的数据库代码;不询问栈已定义的工具选择。