One CLI Blog

工程笔记和产品设计记录

记录 One CLI 的 manifest、preset、agent skill 和模板治理设计，方便后续决策有上下文可追溯。

AI-Native Monorepo CLI 到底要控制什么

AI-native monorepo CLI 不只是生成目录，而是给 agent 一个稳定的工作区契约。

安全的 workspace setup 应该从 manifest 开始，只补缺失依赖，并报告执行过的精确命令。

稳定的 JSON envelope 让 agent 根据 error code 和 context 分支，而不是解析给人看的文案。

monorepo 脚手架不应该只记录文件生成在哪里，还应该记录项目为什么存在。

One CLI 关注 workspace 契约和 agent-safe 操作，而不只是初始化生成项目。

当模板同时携带约定、依赖规则和生成说明时，agent 操作会更安全。

One CLI 只暴露一个 bundled skill，里面记录命令契约、preset 词汇和依赖补齐规则。

one.manifest.json 不只是脚手架产物，它是人、CLI 和 agent 共同读取的工程契约。

Preset ID 是可复现的模板组合编码，不应该膨胀成另一个业务场景 DSL。