SuperAPI AI 工具集

soia-dev-project-scaffold

通用与其它

查看项目

更新于 10-16 08:46

技能介绍

用途:为新建或空白的 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> 可用 git -C <project-path> status --short 与 find/sed 复核结果。

依赖与安装:依赖 POSIX shell、mkdir 和 git(仅用于检查,不初始化仓库),无需私有配置。插件方式: claude plugin marketplace add soia-team/soia-open-skills claude plugin install soia-dev@soia 单技能可用 npx: npx skills add soia-team/soia-open-dev-skills -g -a '' -s soia-dev-project-scaffold -y 注意技能会落进共享真源 ~/.agents/skills,若同时安装插件,同一技能会出现两份索引且各自漂移,建议二选一。WorkBuddy 的装载单位是角色化专家而不是插件,npx skills add -a '' 覆盖不到它,需单独安装,见 docs/install/workbuddy.md。

限制:只读取目标目录是否存在及同名文件状态,不扫描目标项目之外的文件,不收集账号、凭据或项目正文;发现同名文件时停止,不创建隐式备份、不覆盖。项目特定规则需客户在生成后的 AGENTS.md 中补充。