ticks
为AI编码智能体设计的多人优先、离线可用的议题追踪器。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：ticks。 它的用途是：为AI编码智能体设计的多人优先、离线可用的议题追踪器。 完整的 Skill 内容见：https://321skill.com/skills/ticks/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“请查看当前项目有哪些待处理的任务，并开始处理下一个优先级最高的。”，它会调用 `tk ready` 命令获取你的待办议题列表，然后使用 `tk next` 获取下一个议题的详细信息，并基于此开始编码或解决问题。或者，在规划新功能时，你可以说：“创建一个关于‘用户登录优化’的新议题，并分配给我”，AI便会执行 `tk create` 来记录这个任务。
介绍
Ticks 解决了AI编码智能体在会话间丢失上下文的核心痛点。传统议题追踪器（如GitHub Issues）查询慢、依赖网络，不适合需要频繁检查状态的智能体工作流。Ticks将议题以JSON文件形式存储在代码仓库中，通过Git追踪，实现了毫秒级查询和离线可用。
使用Ticks非常简单。安装后，在项目目录下运行 tk init 初始化，即可通过 tk ready、tk next 等命令快速创建、查看和管理议题。其命令行输出（如 --json 格式）专为智能体解析设计，便于集成到自动化流程中。
它非常适合需要多个智能体或开发者协作的团队。无论是全栈开发、智能体开发还是项目经理，只要团队在使用AI辅助编码并需要跟踪任务进度和上下文，Ticks都能提供极大便利。其“多人优先”设计默认按所有者（owner）筛选议题，避免了团队内部工作冲突。
建议将Ticks与你的AI代理配置（如AGENTS.md或CLAUDE.md）结合，通过 tk snippet 命令让智能体自动获取项目待办事项。由于议题文件是纯文本JSON，建议团队熟悉基本的Git合并操作以处理可能的编辑冲突。
核心特点
与同类工具（如beads）相比，Ticks是“多人优先”设计，内置所有者（owner）作用域，天然适合多人/多智能体团队协作；同时它完全基于Git和扁平JSON文件，无需后台守护进程或SQLite，更轻量、更易调试。
注意事项
不适合需要复杂多智能体自动协调和上下文注入钩子（hooks）的高级场景。
常见问题
Ticks和GitHub Issues有什么区别？
Ticks查询速度极快（~35ms），支持离线工作，输出为智能体优化，且议题随Git分支/合并而流动，更适合AI代理高频检查状态的工作流。
Ticks如何保证多人协作不冲突？
通过内置的“所有者（owner）”作用域，默认命令（如`tk ready`）只显示当前用户/智能体的议题，使用`--all`参数才查看全部，有效隔离工作区。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/ticks/raw/index.md 读取 ticks 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/ticks/raw/index.md（查看排版版本）