my-workflow
为AI编码代理提供本地优先、可追溯的工作流管理框架。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：my-workflow。 它的用途是：为AI编码代理提供本地优先、可追溯的工作流管理框架。 完整的 Skill 内容见：https://321skill.com/skills/my-workflow/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请为这个新用户登录功能创建一个maestro特性卡片，并拆解出前三个开发任务。” 它会先生成包含 `spec.md`（功能规格）和 `qa.md`（验收标准）的特性卡片。然后，你可以运行 `maestro ready` 查看可执行的任务列表，并用 `maestro task claim <task-id>` 让AI代理认领并开始第一个任务。
介绍
maestro 旨在解决AI编码代理在跨会话协作时容易“遗忘”和“混乱”的问题。它为AI驱动的代码库提供了一个本地优先的治理层，将工作项、任务、决策和验证证据都以卡片的形式持久化存储在项目目录的 .maestro/ 文件夹中，确保工作状态可查询、可审计。
使用时，开发者或AI代理通过CLI命令（如 maestro task start）来创建、认领和推进任务。所有工作记录（如需求规格、验收标准、完成证明）都以纯文本文件（如 card.yaml, spec.md, qa.md）的形式保存，便于代码审查和版本控制。
它非常适合依赖AI代理进行复杂或长期项目开发的团队或个人，尤其是那些需要确保AI工作可追溯、可验证，并避免任务冲突的场景。
建议在项目初期就引入maestro，以建立规范的工作流。需要注意的是，它本身不执行代码，而是管理工作的生命周期，因此需要与具体的AI编码工具（如Claude、Cursor）配合使用。
核心特点
核心区别在于其“本地优先、无守护进程”的架构，所有状态都存储为项目内的普通文件，无需云端服务或后台进程，实现了完全的可移植性和可审查性。同时，它将工作抽象为“卡片”和“任务”两层模型，既支持轻量级的快速任务，也支持带严格门控（如证明、QA）的复杂功能开发。
注意事项
不适合仅需单次、临时性代码生成且无需追踪历史或协作的场景。
常见问题
maestro 和普通的任务管理工具有什么不同？
maestro 专为AI代理设计，深度集成了工作生命周期管理（如认领、证明、QA门控），并将所有状态以开发者友好的文件形式存储，便于Git追踪和人工审查。
我需要一直运行一个maestro服务吗？
不需要。maestro是一个单文件Rust二进制工具，通过CLI命令交互，没有需要长期运行的后台服务或守护进程。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/my-workflow/raw/index.md 读取 my-workflow 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/my-workflow/raw/index.md（查看排版版本）