名称: 项目脚手架工具 描述: “为新的自主学习资源项目创建 plan.md、task.md、persona.md、project-context.md 和 CLAUDE.md 文件。使用场景: (1) 当 /init 命令被调用时, (2) 设置新的教程/指南/文档项目时, (3) 结构设计代理需要学习资源结构设计模板时。提供带有页面分配的分级（部分/章节/小节）模板。” 允许的工具: 读取, 写入, Bash, Glob
项目脚手架技能
此技能为搭建新的自主学习资源项目提供模板和指导。
模板
此技能目录中提供以下模板：
| 模板 | 用途 |
|---|---|
| plan-template.md | 包含部分/章节/小节层次结构的项目结构 |
| task-template.md | 基于会话的任务清单，与 plan.md 对应 |
| persona-template.md | 作者/读者角色和代码策略定义 |
| project-context-template.md | 目标环境和参考网址 |
| claude-md-template.md | CLAUDE.md 项目说明 |
工作流程
1. 信息收集
在搭建脚手架之前，收集以下信息：
- 主题: 学习资源的主题
- 总页数: 预估页数 (50/100/200+)
- 语言: 主要语言 (ko/en)
- 目标受众: 经验水平 (初学者/中级/高级)
- 目标环境: 操作系统、工具、版本
2. 文件生成顺序
plan.md- 主结构文档 (使用 plan-template.md)task.md- 按会话划分的清单 (使用 task-template.md)persona.md- 作者/读者定义 (使用 persona-template.md)project-context.md- 环境和参考 (使用 project-context-template.md)CLAUDE.md- 给 Claude 的项目说明 (使用 claude-md-template.md)
3. 结构指南
层次结构
- 部分: 主要主题 (50-100 页)，包含 3-6 个章节
- 章节: 主题组 (15-30 页)，包含 3-5 个小节
- 小节: 单一概念 (5-12 页)
页面分配公式
| 内容类型 | 百分比 |
|---|---|
| 介绍/概述 | 5-8% |
| 核心内容 | 60-70% |
| 练习/示例 | 20-25% |
| 总结/回顾 | 5-8% |
4. 会话划分规则
创建 task.md 时，将工作划分为 Claude Code 会话：
- 1 个会话 = 3-5 个小节或 20-40 页
- 在同一章节/部分内对小节进行分组
- 考虑依赖关系 (先决条件 → 后续内容)
- 使用 HTML 注释标记会话边界：
<!-- Session 1: Part 1 Foundations -->
- [ ] 1.1 Introduction (8p)
- [ ] 1.2 Core Concepts (7p)
<!-- Session 2: Part 1 Architecture -->
- [ ] 1.3 System Design (10p)
5. 占位符变量
对所有占位符使用 {VARIABLE_NAME} 格式：
| 变量 | 描述 |
|---|---|
{PROJECT_TITLE} |
项目名称 |
{TARGET_SYSTEM} |
目标操作系统/环境 |
{TARGET_AUDIENCE} |
读者经验水平 |
{TOTAL_PAGES} |
总预估页数 |
{DATE} |
创建/更新日期 |
{PART_TITLE} |
部分标题 |
{CHAPTER_TITLE} |
章节标题 |
{SECTION_TITLE} |
小节标题 |
{PAGES} |
小节页数 |
质量检查清单
在完成脚手架搭建之前，请验证：