Joan工作流指南

技能简介

Joan是一款面向AI辅助开发的命令行工具，通过Workspace组织Pods（领域知识文档）、Todos（任务）和Plans（实现方案），帮助团队在开发过程中同步上下文、沉淀知识。

能做什么

• 初始化项目并关联Workspace
• 创建和管理版本化的领域知识文档（Pods）
• 跟踪任务状态并与知识文档关联
• 生成AI上下文文件（CLADE.md）
• 通过MCP服务器与AI助手集成

使用说明

安装

Joan需通过包管理器或源码安装，具体安装指令请查阅官方仓库。安装后执行joan auth login完成OAuth认证。

快速开始

1. 在项目目录执行joan init，交互式选择或指定Workspace
2. 执行joan pod add添加相关领域知识文档
3. 运行joan context claude生成AI上下文
4. 开发前执行joan pod pull获取最新知识

日常 workflow

• 查看任务：joan todo list --mine
• 创建知识文档：joan pod create，编辑后joan pod push
• 更新任务状态：joan todo update <id>
• 归档完成任务：joan todo archive <id>

输入与输出

见下方输入与输出表格。

风险提示

• 本地Pods修改后需手动push，否则团队成员无法获取更新
• 删除本地.joan目录将导致未push的变更丢失
• MCP服务需先完成CLI认证方可调用
• Workspace权限由管理员控制，无权限成员无法访问敏感Pods

来源信息

原始链接：https://github.com/openclaw/skills/tree/main/skills/donny-son/joan-workflow/SKILL.md
来源类型：GitHub仓库