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 organization-internal 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-dev-coding-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