用途:为新建或空白的 Git 项目创建一套最小、可编辑的 AI 协作基线,包含 AGENTS.md、文档导航、项目概览、变更记录和 AI 工作记录目录。不生成应用框架、云服务模块或组织内部治理结构。
主要能力:生成 AGENTS.md、docs/navigation.md、docs/project-overview.md、docs/product/README.md、docs/changelog/README.md、docs/ai-workspace/README.md、docs/templates/README.md。
使用方式:提供目标项目的绝对路径并明确允许创建文件。先运行帮助或检查目录;目标已有同名文件时,先展示差异并取得覆盖确认。
bash skills/soia-dev-project-scaffold/shells/init-project-baseline.sh <project-path>
安装:
npx skills add soia-team/soia-open-skills -g -a '*' -s soia-dev-project-scaffold -y
依赖 POSIX shell、mkdir 和 git(仅用于检查,不初始化仓库)。不需要私有配置;项目特定规则应由客户在生成后的 AGENTS.md 中补充。
验证:
bash skills/soia-dev-project-scaffold/shells/init-project-baseline.sh --help bash -n skills/soia-dev-project-scaffold/shells/init-project-baseline.sh
适用场景:新建 Git 项目、补 AGENTS.md、建立 docs/ 导航等请求。
限制:不用于已有项目的大规模重构、语言/框架脚手架,或需要组织专属目录模板的项目。