Customer-readable description
What this skill can do
Create a minimal, editable AI collaboration baseline for a newly created or blank Git project:AGENTS.md, documentation navigation, project overview, change log, and AI work log directory. It does not generate application frameworks, cloud service modules, or internal organizational governance structures.
How customers use it
Provide the absolute path of the target project and explicitly allow file creation. First run help or check the directory; if the target already has files with the same names, show the differences first and obtain confirmation to overwrite.
bash skills/soia-dev-project-scaffold/shells/init-project-baseline.sh <project-path>
Dependencies and installation
npx skills add soia-team/soia-open-skills -g -a '*' -s soia-dev-project-scaffold -y
Depends on POSIX shell,mkdir and git(used only for checking, does not initialize the repository). No private configuration is required; project-specific rules should be added by the customer in the generated AGENTS.md .
Logs and completion receipt
完成:<已创建或预览的基线>。
日志摘要:
- target: <绝对路径>
- created/updated: <文件列表>
- skipped/failed: <原因或无>
验证:<git status、文件清单和读取检查>
问题与下一步:<需要填充的项目规则或无>
Applicability and boundaries
Applies to requests such as "new Git project", "add AGENTS.md", and "set up docs/ navigation". Not for large-scale refactoring of existing projects, language/framework scaffolding, or projects that require organization-specific directory templates.
Minimal process
- Confirm the absolute target path and write authorization.
- Check whether
AGENTS.mdor the docs files to be generated already exist; if they do, stop first and ask whether to overwrite. - Run the script, or create manually according to the same file list.
- Use
git -C <project-path> status --shortandfind/sedto review the generated results. - The receipt lists the created items, verification evidence, and project rules that the customer still needs to fill in.
Output
Script-generated:
AGENTS.mddocs/navigation.mddocs/project-overview.mddocs/product/README.mddocs/changelog/README.mddocs/ai-workspace/README.mddocs/templates/README.md
Verification
bash skills/soia-dev-project-scaffold/shells/init-project-baseline.sh --help
bash -n skills/soia-dev-project-scaffold/shells/init-project-baseline.sh