SuperAPI AI Directory

soia-dev-project-scaffold

Coding & development

View repository

Updated 10-16 09:30

About this skill

soia-dev-project-scaffold

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

  1. Confirm the absolute target path and write authorization.
  2. Check whether AGENTS.md or the docs files to be generated already exist; if they do, stop first and ask whether to overwrite.
  3. Run the script, or create manually according to the same file list.
  4. Use git -C <project-path> status --short and find/sed to review the generated results.
  5. The receipt lists the created items, verification evidence, and project rules that the customer still needs to fill in.

Output

Script-generated:

  • 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

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