SuperAPI AI 工具集

soia-dev-project-scaffold

编程与开发

查看项目

更新于 10-16 09:30

技能介绍

用途:为一个新建或空白的 Git 项目创建最小、可编辑的 AI 协作基线,生成 AGENTS.md、docs 导航、项目概览、变更记录和 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-dev-coding-skills -g -a '*' -s soia-dev-project-scaffold -y。依赖 POSIX shell、mkdir 和 git(仅用于检查,不初始化仓库),不需要私有配置。

验证: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 -C <project-path> status --short 和 find/sed 复核生成结果,并回执创建项、验证证据及仍需填写的项目规则。

适用场景:新建 Git 项目、补 AGENTS.md、建立 docs/ 导航。限制:不用于已有项目的大规模重构、语言或框架脚手架,或需要组织专属目录模板的项目;项目特定规则需由使用者在生成后的 AGENTS.md 中补充。