project-init
npx machina-cli add skill u9401066/template-is-all-you-need/project-init --openclawFiles (1)
SKILL.md
5.0 KB
專案初始化技能
描述
將此專案作為模板,快速初始化新專案,完整繼承法規系統和 Skills 架構。
觸發條件
- 「初始化新專案」「init」「新專案」
- 「從模板建立專案」「template」
- 「create new project」「bootstrap」
🔧 操作步驟
Step 1: 收集專案資訊
詢問使用者:
請提供新專案資訊:
1. **專案名稱**:my-awesome-project
2. **專案描述**:一句話描述
3. **專案類型**:
- [ ] Python 後端
- [ ] Node.js 後端
- [ ] React 前端
- [ ] Vue 前端
- [ ] 全端 (Monorepo)
4. **授權類型**:MIT / Apache-2.0 / GPL-3.0
5. **目標路徑**:~/projects/my-awesome-project
Step 2: 建立目錄結構
# 建立專案目錄
New-Item -ItemType Directory -Path "C:\projects\my-awesome-project" -Force
# 建立核心目錄
$dirs = @(
".github\bylaws",
".github\workflows",
".github\ISSUE_TEMPLATE",
".claude\skills",
"memory-bank",
"docs",
"tests"
)
foreach ($dir in $dirs) {
New-Item -ItemType Directory -Path "C:\projects\my-awesome-project\$dir" -Force
}
Step 3: 複製法規系統
| 檔案/目錄 | 動作 | 說明 |
|---|---|---|
| CONSTITUTION.md | 複製 | 憲法 |
| .github/bylaws/*.md | 複製 | 所有子法 |
| .github/copilot-instructions.md | 複製並修改 | 更新專案名稱 |
Step 4: 複製 Skills
# 複製整個 skills 目錄
Copy-Item -Path "D:\template\.claude\skills\*" -Destination "C:\projects\my-awesome-project\.claude\skills" -Recurse
Step 5: 初始化 Memory Bank
建立空的 Memory Bank 檔案:
$memoryFiles = @(
"activeContext.md",
"progress.md",
"decisionLog.md",
"architect.md",
"productContext.md",
"projectBrief.md",
"systemPatterns.md"
)
foreach ($file in $memoryFiles) {
New-Item -ItemType File -Path "C:\projects\my-awesome-project\memory-bank\$file" -Force
}
初始內容範例(activeContext.md):
# Active Context
> Last updated: 2026-01-15
## 🎯 當前焦點
專案剛初始化,尚未開始開發。
## 📁 相關檔案
- 待新增
## ⚠️ 待解決問題
- [ ] 設定開發環境
- [ ] 定義領域模型
Step 6: 初始化專案檔案
README.md:
# {專案名稱}
> {專案描述}
## ✨ 功能特色
- 待新增
## 📦 安裝
\`\`\`bash
# 待補充
\`\`\`
## 🚀 快速開始
\`\`\`bash
# 待補充
\`\`\`
## 📄 授權
{授權類型} License
CHANGELOG.md:
# Changelog
All notable changes to this project will be documented in this file.
## [Unreleased]
### Added
- 專案初始化
Step 7: 初始化 Git
cd "C:\projects\my-awesome-project"
git init
git add .
git commit -m "chore: 初始化專案 (使用 template-is-all-you-need)"
Step 8: 依專案類型設定
Python 專案
# 建立 pyproject.toml
Copy-Item "D:\template\pyproject.toml.template" "pyproject.toml"
# 建立虛擬環境
uv venv
uv sync --all-extras
Node.js 專案
npm init -y
npm install --save-dev typescript @types/node
📁 複製內容對照表
| 來源 | 目標 | 動作 |
|---|---|---|
| CONSTITUTION.md | CONSTITUTION.md | 複製 |
| .github/bylaws/*.md | .github/bylaws/*.md | 複製 |
| .github/copilot-instructions.md | .github/copilot-instructions.md | 複製並編輯 |
| .claude/skills/* | .claude/skills/* | 複製 |
| memory-bank/*.md | memory-bank/*.md | 建立空檔 |
| README.md | README.md | 重新生成 |
| CHANGELOG.md | CHANGELOG.md | 重新生成 |
| .gitignore | .gitignore | 複製 |
| .git/ | .git/ | 重新初始化 |
📊 輸出格式
🚀 專案初始化完成
專案資訊:
- 名稱:my-awesome-project
- 類型:Python 後端
- 位置:C:\projects\my-awesome-project
已建立:
- ✅ 目錄結構
- ✅ 憲法與子法 (CONSTITUTION.md + 4 bylaws)
- ✅ Claude Skills (19 個)
- ✅ Memory Bank (7 個空檔案)
- ✅ README.md / CHANGELOG.md
- ✅ Git 初始化
下一步:
1. cd C:\projects\my-awesome-project
2. code .
3. 執行「更新 memory bank」記錄專案目標
⚠️ 注意事項
- 不要複製 data/ 目錄:這是模板專案的暫存資料
- 重設所有版本號:CHANGELOG 從 Unreleased 開始
- 清空 Memory Bank:不要複製模板的記憶內容
- 更新專案名稱:搜尋並替換所有 "template-is-all-you-need"
Source
git clone https://github.com/u9401066/template-is-all-you-need/blob/master/.claude/skills/project-init/SKILL.mdView on GitHub Overview
project-init 快速以模板初始化新專案,繼承既定 governance 與 Skills 架構,確保憲法與子法、memory-bank、文件與測試目錄等核心元件完整支援。透過統一的起始結構,讓團隊能更快開始開發並維持一致性。
How This Skill Works
使用者觸發後,會收集專案名稱、描述、類型、授權與目標路徑等資訊;接著建立目錄結構、複製並編輯治理檔案與技能資源(CONSTITUTION.md、.github/bylaws、.github/workflows、.claude/skills、memory-bank、docs、tests),初始化 README.md 與 CHANGELOG.md,然後初始化 Git 儲存庫,最後根據專案類型執行 Python 或 Node.js 的起始設定。
When to Use It
- 當你要以模板快速啟動新專案(觸發條件:init、new、新專案、template、bootstrap、scaffold project 等)
- 需要完整繼承法規系統與 Skills 架構
- 需要建立全端或單一語言的標準起始結構(如 Monorepo、Python 或 Node.js 專案)
- 為新團隊上手提供一致的起始點與文件
- 需要快速複製並分叉模板以建立新專案
Quick Start
- Step 1: 收集專案資訊(名稱、描述、類型、授權、目標路徑)
- Step 2: 建立目錄結構並複製核心治理與技能資源(CONSTITUTION.md、.github、.claude/skills、memory-bank、docs、tests)
- Step 3: 初始化 memory bank、README.md、CHANGELOG.md,並根據專案類型完成 Git 與初始設定
Best Practices
- 在啟動前核對專案名稱、描述與授權等核心資訊
- 替換模板中的占位符(如 {專案名稱}、授權類型)
- 完成 memory bank、README.md、CHANGELOG.md 後再執行 Git 初始化
- 分別按照專案類型執行 Python 或 Node.js 的初始設定
- 定期更新模板內容,維護治理與技能架構的一致性
Example Use Cases
- 新建立 Python 後端專案,使用 MIT 授權,路徑為 C:\projects\my-python-backend
- 建立 React 前端 Monorepo,包含 docs、memory-bank 與測試目錄
- 為開源專案複製模板,快速產出第一版 CHANGELOG 並提交
- 新團隊上手,使用模板建立標準化專案架構以利協作
- 建立內部工具專案倉庫,採用 template-is-all-you-need 的治理與技能結構
Frequently Asked Questions
Add this skill to your agents