init — 一键写出项目的 AGENTS.md

简介

Agent 进仓库第一件事本该是读项目规则，现实里常是没规则、规则过时、迁移成本高、入口不统一。没有高信号规则，agent 容易猜错测试命令、改错包边界、重复踩环境坑。@piex-dev/init 收成：pi install 一次，之后 /init 即可。

技术原理

pi 只加载规则不生成规则：内核从 ~/.pi/agent 与 cwd 向上发现 AGENTS.md/CLAUDE.md 注入 system prompt，但内置 slash 没有 /init。Prompt template = 零代码 slash 命令：prompts/init.md 文件名即命令名，支持 $ARGUMENTS，pi 展开为完整 user message 交给当前会话模型。

价值在调查清单不在模板长度：好的 init prompt 规定三件事——先读什么、提取什么、写什么/不写什么。可执行源（package.json scripts、CI、lockfile）优先于散文 README；已有规则就地改进不盲目覆盖。

使用说明

安装

pi install npm:@piex-dev/init

仓库源码：prompts/init

用法

/init           # 扫描当前仓库并生成/改进 AGENTS.md
/init <说明>    # 带额外说明

写完提示 /reload 使当前会话生效。

配置

纯 prompt 包，无 TypeScript、无 peer 依赖、无运行时代码。package.json 声明 "pi": { "prompts": ["./init.md"] }，prompts/init.md 即命令本体。

实现方案

本包是纯 prompt 包，无 extensions/、无 peer 依赖。

prompts/init/
├── package.json          # "pi": { "prompts": ["./init.md"] }
├── README.md
└── init.md

init.md 要求：优先读 README/manifest/构建测试 CI/既有 instruction/.pi/settings.json；只保留 agent 容易猜错的高信号事实；仓库答不上的才向用户提问；写到项目根 AGENTS.md，写完提示 /reload。刻意不做：全局 ~/.pi/agent/AGENTS.md 自动写入、交互菜单、extension 包装。

设计参考

结论：生成逻辑应是「可分发的 prompt」，不是第二个 agent 内核功能。

迭代记录

路线图

版本记录