SuperAPI AI Directory

soia-dev-project-scaffold

Coding & development

View repository

Updated 10-16 08:50

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 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

  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