用途:作为项目启动的统一入口,既可为新项目生成脚手架并接入工作流,也可为已有项目添加 agents-workflow 系统,是功能规划前的第 0 步。
主要能力:支持三种技术栈。nextjs 使用 Bun、Next.js 15 App Router、Tailwind v4、Zustand、TanStack Query,测试用 Vitest + RTL + Playwright,检查用 Biome;python 使用 uv 与 src 布局,测试用 pytest,检查用 Ruff + pyright;rust 使用 Cargo workspace,测试用 cargo-nextest,检查用 clippy + rustfmt。新项目流程为选择技术栈、校验名称、按 templates/ 模板生成结构、接入工作流、安装依赖、验证 lint 与构建测试。
使用方式:/skill:init 交互式自动检测;/skill:init nextjs my-app 新建 Next.js 项目;/skill:init python my-service 新建 Python 项目;/skill:init rust my-crate 新建 Rust 项目;/skill:init --setup 为已有项目添加工作流。无参数时自动判断模式。
已有项目接入:要求是 git 仓库且有写权限。会自动配置分支:无提交则创建初始提交、main 与 dev;仅有 master 则重命名为 main 并创建 dev;仅有 main 则创建 dev;两者都有则不变。同时配置 worktrunk 的 worktree-path 与 .gitignore。agents、prompts、scripts 以符号链接指向 agents-workflow 根目录,extensions 与 skills 不链接以免工具冲突。创建 .pi/settings.json、项目专属 AGENTS.md 存根,以及 docs/ 下的 prds、specs、plans、research、tasks、decisions、reviews 目录。
适用场景:需要快速搭建规范项目结构并统一多项目工作流定义的团队或个人。
限制:必须为 git 仓库;需目录写权限;模板变量包括 {{PROJECT_NAME}}、{{PROJECT_NAME_SNAKE}}、{{PROJECT_NAME_PASCAL}}、{{YEAR}}、{{DATE}};具体收费、平台支持范围等资料暂未提供。