AgentSkillsCN

init-project

以代理式编码结构初始化项目。适用于新项目搭建、为现有项目添加 AI 代理支持,以及当用户输入“初始化”“设置项目”或“生成脚手架”时。该流程会自动创建 AGENTS 文件夹、文档模板,并设立 _NOTES 临时工作区。

SKILL.md
--- frontmatter
name: init-project
description: Initialize projects with agentic coding structure. Use when setting up a new project, adding AI agent support to existing project, or when user says "init", "initialize", "setup project", or "scaffold". Creates AGENTS folder, documentation templates, and _NOTES scratch space.

Project Initialization Workflow

Scaffold projects with agentic coding structure for AI-assisted development.

Execution Steps

1. Determine Target Directory

  • Default: Current working directory
  • If user specifies a path, use that instead
  • If directory doesn't exist, offer to create it

2. Gather Requirements

RequiredQuestionDefault
Project name?Directory name
Project type?general
License preference?MIT
Brief description?"A new project"

Skip questions if context provides answers.

3. Check for Existing Files

Before creating, check what already exists:

If ExistsAction
README.mdSkip — preserve existing
CHANGELOG.mdSkip — preserve existing
LICENSESkip — preserve existing
.gitignoreMerge — append missing entries
_NOTES/Skip — preserve existing
AGENTS/Create missing parts only

This allows safe re-runs on existing projects to add agentic structure.

4. Confirm Before Creating

Show user:

  • Target path
  • Files to be created (noting any skipped)
  • Project type selected

Wait for confirmation.

5. Create Directory Structure

code
<project-root>/
├── README.md
├── CHANGELOG.md
├── LICENSE
├── .gitignore
├── _NOTES/
│   └── .gitkeep
└── AGENTS/
    └── claude-opus-4.5/
        ├── CONTEXT.md
        ├── TODO.md
        ├── DECISIONS.md
        └── SESSION-LOG/

6. Populate Files

Use templates from assets/ folder, substituting:

  • {{PROJECT_NAME}} — Project name
  • {{DESCRIPTION}} — Project description
  • {{DATE}} — Current date (YYYY-MM-DD)
  • {{YEAR}} — Current year

7. Add Type-Specific Files

TypeAdditional Structure
generalBase structure only
code-python+ src/, tests/, pyproject.toml
code-node+ src/, package.json

See references/project-types.md for details.

8. Confirm Completion

Report:

  • Full path created
  • Files generated
  • Suggested next steps

Template Assets

FileSource
README.mdassets/README.template.md
CHANGELOG.mdassets/CHANGELOG.template.md
LICENSE (MIT)assets/LICENSE-MIT.txt
LICENSE (Apache)assets/LICENSE-Apache2.txt
.gitignoreassets/gitignore-general.txt
CONTEXT.mdassets/CONTEXT.template.md
TODO.mdassets/TODO.template.md
DECISIONS.mdassets/DECISIONS.template.md

Integration

This skill creates structure compatible with /wrap-session:

Init CreatesWrap-Session Updates
README.mdREADME.md (with progress)
CHANGELOG.mdCHANGELOG.md (with changes)
CONTEXT.mdCONTEXT.md (current state)
TODO.mdTODO.md (with tasks)
SESSION-LOG/SESSION-LOG/*.md