SuperAPI AI 工具集

start-project

办公与效率

查看项目

更新于 10-16 08:27

技能介绍

用途

start-project 用于创建带有标准化结构、明确完成标准和 PARA 组织方式的新项目。其核心理念是:没有结构的项目容易变成“僵尸项目”——既没有真正完成,也没有被放弃。通过规范化的项目设置,每个项目都有清晰的“完成”标准,状态可通过 frontmatter 跟踪,其他技能(如 log-to-project、weekly-review)也能正确协作,避免事项被遗漏。

主要能力

  • 引导用户收集项目信息:项目名称、类型、所属领域、优先级、目标完成日期、一句话目标、完成标准。
  • 校验项目名称是否为空、是否已存在,校验状态和优先级取值,并强制要求至少定义一条完成标准。
  • 创建项目文件夹:02 Projects/[Project Name]/。
  • 生成 PROJECT.md 文件,包含 frontmatter 和正文模板。
  • 根据项目类型创建对应的子文件夹。
  • 对于 software 类型项目,建议创建 CLAUDE.md。
  • 创建完成后展示结构,提醒用户填写占位符,并建议后续步骤。

项目类型与子文件夹

类型 说明 默认子文件夹
general 标准项目 无
software 代码/开发 Sessions/, Decisions/
content 写作/创作 Drafts/, Research/
learning 技能习得 Resources/, Notes/

使用方式

配置

在 CLAUDE.md 中添加:

## Vault Configuration
Projects location: 02 Projects/
Incubation folder: 02 Projects/_Incubation/

## Project Areas (customize for your work)
Areas:
  - work: Work projects
  - personal: Personal projects
  - learning: Learning/skill projects

快速开始

  1. 获取项目名称和类型。
  2. 询问完成标准(什么定义了“完成”?)。
  3. 创建项目文件夹和 PROJECT.md。
  4. 创建类型专属子文件夹。
  5. 确认创建结果。

处理流程

第 1 步:收集信息

向用户询问:

  • 项目名称——应该叫什么?
  • 类型——general、software、content、learning。
  • 领域——属于哪个工作领域?(用户自定义)
  • 优先级——critical、high、medium、low。
  • 目标完成日期——具体日期或留空。
  • 一句话目标——期望的结果是什么?
  • 完成标准——什么定义了“完成”?(至少 2-3 项)

第 2 步:校验

  • 检查文件夹是否已存在。
  • 确保完成标准已定义(没有“完成”标准的项目会变成僵尸项目)。
  • 校验状态和优先级取值。

第 3 步:创建结构

  • 创建文件夹:02 Projects/[Project Name]/。
  • 使用模板创建 PROJECT.md。
  • 根据类型创建子文件夹。
  • 对于 software 项目,建议创建 CLAUDE.md。

第 4 步:确认

  • 展示创建的内容。
  • 提醒用户填写所有占位符。
  • 建议后续步骤。

PROJECT.md 模板

这是每个项目都必须具备的规范项目文件:

---
project: "[PROJECT_NAME]"
type: "[TYPE]"
status: "planning"
priority: "medium"
area: "[AREA]"
start_date: "[TODAY]"
target_completion: "[DEADLINE_OR_EMPTY]"
tags:
  - project
created: "[TODAY]"
updated: "[TODAY]"
---

# [PROJECT_NAME]

## Overview

**Goal:** [One sentence goal]

**Why this matters:** [Brief context]

## Completion Criteria

What defines "done" for this project:

- [ ] Criterion 1
- [ ] Criterion 2
- [ ] Criterion 3

## Status

| Field | Value |
|-------|-------|
| Status | planning |
| Priority | medium |
| Started | [TODAY] |
| Target | [DEADLINE] |
| Progress | 0% |

## Next Actions

- [ ] First action

## Progress Log

### [TODAY]
- Project created

---

## Reference

**Status values:** planning, active, on-hold, blocked, review, completed
**Priority values:** critical, high, medium, low

校验规则

  • 项目名称——非空,且尚不存在。
  • 状态——必须为:planning、active、on-hold、blocked、review、completed。
  • 优先级——必须为:critical、high、medium、low。
  • 完成标准——至少一项(不可协商)。

适用场景

  • 需要以统一结构创建个人或工作项目。
  • 使用 PARA 方法管理项目库(vault)。
  • 希望项目具备明确完成标准和状态跟踪。
  • 与 log-to-project、weekly-review 等技能配合使用。

限制

  • 资料未提供该技能的收费、价格、平台支持范围等信息。
  • 资料未提供安装命令或依赖要求。
  • 资料未提供除 CLAUDE.md 配置外的其他集成方式。
  • 资料未提供多用户协作、权限控制等能力说明。

提示

  • 如果完成标准模糊,帮助用户思考“完成”应该是什么样子。
  • 对于 software 项目,链接到代码仓库。
  • 如果截止日期是“ASAP”或模糊,推动用户给出具体日期或“无截止日期”。
  • 没有明确完成标准的项目容易拖延——应强制执行此要求。

成功标准

  • 项目文件夹已存在。
  • PROJECT.md 具有有效的 frontmatter。
  • 所有 frontmatter 字段已填充(无占位符)。
  • 至少定义了一条完成标准。
  • 已创建适当的子文件夹。
  • 已向用户展示创建的结构。