# seam-flow-skills

**Repository Path**: AI-LLM/seam-flow-skills

## Basic Information

- **Project Name**: seam-flow-skills
- **Description**: 可衔接持续交付研发skills
“让需求衔流起来”“今日衔流三任务”
「衔」接无痕 · 「流」转不息
- **Primary Language**: YAML
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-26
- **Last Updated**: 2026-02-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Seam Flow Skills

## 功能简介

在长时间AI协助开发项目中，使用tasks.json文件来跟踪任务状态和进度。解决上下文丢失和任务混乱问题，提供跨会话状态恢复能力。

## 如何使用

1. 在项目根目录创建或确保有`tasks.json`文件
2. 使用自然语言指令管理任务

### 任务管理指令

- **启动任务**：`开始处理任务 TASK-001` 或 `启动 TASK-001`
- **完成任务**：`完成任务 TASK-001` 或 `已完成 TASK-001`
- **记录进度**：`进度：TASK-001 - 实现登录功能`
- **阻塞任务**：`阻塞任务 TASK-002: 等待依赖TASK-001完成`
- **解除阻塞**：`解除阻塞 TASK-002`
- **查看状态**：`显示项目状态` 或 `现在的进度是什么`

### 任务状态

- `待办(todo)` - 已规划但未开始
- `进行中(in-progress)` - 正在开发
- `阻塞(blocked)` - 因依赖等待中
- `已完成(completed)` - 已完成

### 校验标准

完成任务时自动检查DOD（定义完成）：
1. 实现验证 - 代码已按规格实现
2. 基本测试 - 功能正常工作
3. 文档更新 - 如需要相应文档已更新

## 实际应用示例

### 从创建到完成的完整流程
假设要开发一个用户认证模块：

1. **开始项目**
   ```
   用户: "今天开始用户认证模块开发"
   AI: "创建新任务 AUTH-001: 实现用户认证模块，状态为'待办'"
   ```

2. **启动任务**
   ```
   用户: "开始处理 AUTH-001"
   AI: "验证无前置依赖，将AUTH-001状态更新为'进行中'"
   ```

3. **记录进度**
   ```
   用户: "进度：AUTH-001 - 已完成用户模型设计"
   AI: "已更新进度日志，时间戳标记为当前时刻"
   ```

4. **完成任务**
   ```
   用户: "完成任务 AUTH-001"
   AI: "验证AUTH-001符合完成标准...更新状态为'已完成'，完成时间为XXX"
   ```

5. **查看状态**
   ```
   用户: "现在整个项目什么状态？"
   AI: "共5个任务，已完成3个，进行中1个，阻塞1个..."
   ```

## tasks.json详解

tasks.json是本技能的核心数据文件，它不仅是任务列表，更是跨会话状态恢复机制的关键。

### 文件定位

- **中央状态存储**：项目的真实来源（single source of truth）
- **上下文恢复**：AI助手通过此文件在新会话中恢复项目上下文
- **持久化记录**：保证任务进度在会话间得以保存
- **协作桥梁**：团队成员可以通过此文件了解整体项目状况

### 使用说明

#### 初始创建
```bash
touch tasks.json  # 在项目根目录
# 或使用AI生成初始模板
```

#### 自动维护
- AI助手在执行命令时自动化更新状态
- 记录任务启动/完成时间
- 维护依赖关系
- 保存进度日志

#### 手动管理
- 可手动编辑tasks.json来自定义任务
- 为任务设置优先级和依赖
- 批量创建或修改任务

### 故障排除

#### 常见问题及解决方案

1. **AI说找不到任务**
   - 确认 `tasks.json` 中确实定义了该任务
   - 检查任务ID的准确拼写

2. **无法开始依赖任务**
   - 检查被依赖的任务是否已完成
   - 任务依赖必须是'completed'状态才能解锁依赖项

3. **状态没有更新**
   - 确保AI执行了对应的命令
   - 检查 `tasks.json` 是否有权限写入

4. **AI不记住上下文**
   - 确保在包含 `tasks.json` 的目录中工作
   - 确认文件没有被其他程序锁定或修改

### 注意事项
- **备份重要**：重要项目建议定期备份此文件
- **格式严谨**：保持合法JSON格式，建议使用代码编辑器以避免语法错误
- **冲突预防**：多人协作时要注意并发更新可能引起的冲突

## 完整的tasks.json示例

```json
{
  "project": "my-project",
  "tasks": [
    {
      "id": "AUTH-001",
      "title": "用户认证模块",
      "description": "实现用户注册、登录和权限验证功能",
      "status": "todo",
      "priority": "high",
      "depends_on": [],
      "created_at": "2025-01-01T00:00:00Z",
      "updated_at": "2025-01-01T00:00:00Z",
      "completed_at": null,
      "progress_log": [
        {
          "timestamp": "2025-01-01T10:30:00Z",
          "entry": "完成数据库设计"
        }
      ]
    }
  ]
}
```