首先，读取安装的版本：如果[-n“$CLAUDE_PLUGIN_ROOT”];那么猫“$CLAUDE_PLUGIN_ROOT/VERSION”2>/dev/null 否则回显“未知” 菲然后输出下面的参考内容，在顶部插入版本。不要添加： * 项目具体分析 * Git 状态或文件上下文 * 下一步建议 * 任何超出参考文献的评论 **版本：** {上面 bash 的版本} **Kata** 是 Claude Code 的规范驱动开发框架。它创建针对代理开发优化的分层项目计划。 ## 快速入门 1. `/kata-new-project` \- 初始化项目（包括研究、要求、路线图） 2. `/kata-plan-phase 1` \- 为第一阶段创建详细计划 3. `/kata-execute-phase 1` \- 执行阶段 ## 保持更新卡塔进化得很快。定期检查更新： /kata-新消息显示自您安装的版本以来发生了什么变化以及如何更新。 ## 核心工作流程 /kata-new-project → /kata-plan-phase → /kata-execute-phase → 重复 ### 项目初始化 **`/kata-new-project`** 通过统一流程初始化新项目。一项技能可以帮助您从想法到做好规划： * 深入提问以了解您正在构建的内容 * 可选领域研究（产生 4 个并行研究代理） * 使用 v1/v2/范围外的需求定义 * 创建路线图，包括阶段分解和成功标准创建所有 `.planning/` 工件： * `PROJECT.md` — 愿景和要求 * `config.json` — 工作流程模式（交互式/yolo） * `research/` — 领域研究（如果选择） * `REQUIREMENTS.md` — 带有 REQ-ID 的范围需求 * `ROADMAP.md` — 映射到需求的阶段 * `STATE.md` — 项目内存用法：`/kata-new-project` **`/kata-map-codebase`** 映射棕地项目的现有代码库。 * 使用并行探索代理分析代码库 * 创建包含 7 个重点文档的 `.planning/codebase/` * 涵盖堆栈、架构、结构、约定、测试、集成、关注点 * 在现有代码库上的 `/kata-new-project` 之前使用用法：`/kata-map-codebase` ### 阶段规划 **`/kata-discuss-phase`** 在规划之前帮助阐明您对某个阶段的愿景。 * 记录您对这一阶段工作的想象 * 根据您的愿景、要点和界限创建 CONTEXT.md * 当您对某物的外观/感觉有想法时使用用法：`/kata-讨论-阶段 2` **`/kata-research-phase`** 针对利基/复杂领域的综合生态系统研究。 * 发现标准堆栈、架构模式、陷阱 * 使用“专家如何构建此”知识创建 RESEARCH.md * 用于 3D、游戏、音频、着色器、ML 和其他专业领域 * 超越“哪个图书馆”到生态系统知识用法：`/kata-research-phase 3` **`/kata-listing-phase-asclusions`** 在开始之前看看 Claude 计划做什么。 * 显示克劳德在某个阶段的预期方法 * 如果克劳德误解了你的愿景，你可以纠正方向 * 未创建文件 - 仅对话输出用法：`/kata-listing-phase-assumes 3` **`/kata-plan-phase`** 为特定阶段创建详细的执行计划。 * 生成 `.planning/phases/pending/XX-phase-name/XX-YY-PLAN.md` * 将阶段分解为具体的、可操作的任务 * 包括验证标准和成功衡量标准 * 每阶段支持多个计划（XX-01、XX-02 等）用法：`/kata-plan-phase 1` 结果：创建`.planning/phases/pending/01-foundation/01-01-PLAN.md` ### 执行 **`/kata-execute-phase`** 执行一个阶段中的所有计划。 * 将阶段从“pending/”→“active/”→“completed/”移动 * 按波次对计划进行分组（来自 frontmatter），按顺序执行波次 * 每波内的计划通过任务工具并行运行 * 所有计划完成后验证阶段目标 * 更新 REQUIREMENTS.md、ROADMAP.md、STATE.md 用法：`/kata-execute-phase 5` ### 快速模式 **`/kata-execute-quick-task`** 使用 Kata 保证执行小型临时任务，但跳过可选代理。快速模式使用相同的系统，但路径较短： * 生成计划者 + 执行者（跳过研究员、检查者、验证者） * 快速任务位于“.planning/quick/”中，与计划阶段分开 * 更新 STATE.md 跟踪（不是 ROADMAP.md）当您确切知道要做什么并且任务足够小以至于不需要研究或验证时使用。用法：`/kata-execute-quick-task` 结果：创建`.planning/quick/NNN-slug/PLAN.md`、`.planning/quick/NNN-slug/SUMMARY.md` ### 路线图管理 **`/kata-add-phase<描述>`** 将新阶段添加到当前里程碑的末尾。 * 附加到 ROADMAP.md * 使用下一个序列号 * 在`pending/`中创建阶段目录用法：`/kata-add-phase“添加管理仪表板”` **`/kata-insert-phase `** 在现有阶段之间插入紧急工作作为小数阶段。 * 创建中间阶段（例如，7 和 8 之间的 7.1） * 对于发现必须在里程碑中期发生的工作很有用 * 保持阶段顺序用法：`/kata-insert-phase 7“修复关键身份验证错误”` 结果：创建阶段 7.1 **`/kata-remove-phase`** 删除未来的阶段并对后续阶段重新编号。 * 删除阶段目录和所有引用 * 重新编号所有后续阶段以缩小差距 * 仅适用于未来（未开始）的阶段 * Git提交保留历史记录用法：`/kata-remove-phase 17` 结果：第 17 阶段被删除，第 18-20 阶段变为 17-19 **`/kata-move-phase<阶段> <操作>`** 在里程碑之间移动阶段或在里程碑内重新排序。 * 跨里程碑：将阶段移至目标里程碑，并对两者重新编号 * 重新排序：更改里程碑内的阶段位置，重新编号所有 * 只能移动待处理的阶段用法：`/kata-move-phase 3 to v1.6.0`（跨里程碑）用法：`/kata-move-phase 3 before 1`（里程碑内重新排序） ### 里程碑管理 **`/kata-add-milestone<名称>`** 通过统一流程开始新的里程碑。 * 深入提问以了解您下一步要构建的内容 * 可选领域研究（产生 4 个并行研究代理） * 需求定义和范围界定 * 创建具有阶段分解的路线图镜像棕地项目的“/kata-new-project”流程（现有 PROJECT.md）。用法：`/kata-add-milestone "v2.0 功能"` **`/kata-complete-milestone<版本>`** 存档已完成的里程碑并为下一个版本做好准备。 * 创建带有统计数据的 MILESTONES.md 条目 * 将完整详细信息存档到里程碑/目录 * 为发布创建 git 标签 * 为下一个版本准备工作空间用法：`/kata-complete-milestone 1.0.0` ### 进度跟踪 **`/kata-track-progress`** 检查项目状态并智能地路由到下一步操作。 * 显示视觉进度条和完成百分比 * 总结摘要文件中的近期工作 * 显示当前位置和下一步 * 列出关键决策和未决问题 * 提议执行下一个计划或在缺失时创建它 * 检测 100% 里程碑完成情况用法：`/kata-track-progress` ### 会话管理 **`/kata-resume-work`** 通过完整的上下文恢复恢复上一个会话的工作。 * 读取 STATE.md 以获取项目上下文 * 显示当前位置和最近进度 * 根据项目状态提供下一步行动用法：`/kata-resume-work` **`/kata-pause-work`** 在工作中期暂停时创建上下文切换。 * 创建具有当前状态的 .continue-here 文件 * 更新 STATE.md 会话连续性部分 * 捕获正在进行的工作环境用法：`/kata-pause-work` ### 调试 **`/kata-debug [问题描述]`** 跨上下文重置具有持久状态的系统调试。 * 通过适应性提问收集症状 * 创建 `.planning/debug/[slug].md` 来跟踪调查 * 使用科学方法进行调查（证据→假设→测试） * 在“/clear”中幸存——运行“/kata-debug”，没有参数来恢复 * 将已解决的问题存档到 `.planning/debug/resolved/` 用法：`/kata-debug“登录按钮不起作用”`用法：`/kata-debug`（恢复活动会话） ### 问题管理 **`/kata-add-issue [描述]`** 从当前对话中捕获想法或任务作为问题。 * 从对话中提取上下文（或使用提供的描述） * 在`.planning/issues/open/`中创建结构化问题文件 * 从文件路径推断区域以进行分组 * 创建前检查重复项 * 更新 STATE.md 问题计数用法：`/kata-add-issue`（从对话中推断）用法：`/kata-add-issue 添加身份验证令牌刷新` **`/kata-check-issues [区域]`** 列出待处理的问题并选择一个要处理的问题。 * 列出所有未决问题，包括标题、区域、年龄 * 可选区域过滤器（例如`/kata-check-issues api`） * 加载所选问题的完整上下文 * 采取适当行动的路线（立即工作、添加到阶段、集思广益） * 将问题移至完成/工作开始时用法：`/kata-check-issues` 用法：`/kata-check-issues api` ### 用户验收测试 **`/kata-verify-work [阶段]`** 通过对话式 UAT 验证内置功能。 * 从SUMMARY.md 文件中提取可测试的可交付成果 * 一次提出一项测试（是/否回答） * 自动诊断故障并创建修复计划 * 如果发现问题，准备重新执行用法：`/kata-verify-work 3` ### 里程碑审计 **`/kata-audit-milestone [版本]`** 根据最初意图审核里程碑完成情况。 * 读取所有阶段 VERIFICATION.md 文件 * 检查需求覆盖范围 * 生成跨相接线的集成检查器 * 创建具有差距和技术债务的 MILESTONE-AUDIT.md 用法：`/kata-audit-milestone` **`/kata-plan-milestone-gaps`** 创建阶段来弥补审计发现的差距。 * 读取 MILESTONE-AUDIT.md 并将差距分组为阶段 * 按需求优先级划分优先级（必须/应该/很好） * 在 ROADMAP.md 中添加差距闭合阶段 * 为新阶段的“/kata-plan-phase”做好准备用法：`/kata-plan-milestone-gaps` ### 配置 **`/kata-customize`** 管理模板覆盖以自定义 Kata 输出格式。 * 列出所有具有覆盖状态的可定制模板 * 复制默认模板进行本地编辑 * 通过对话更改编辑覆盖 * 验证所需模式的覆盖用法：`/kata-customize` 用法：`/kata-customize list` 用法：`/kata-customize copysummary-template.md` 用法：`/kata-customize validate` **`/kata-configure-settings`** 以交互方式配置工作流程切换和模型配置文件。 * 切换研究员、计划检查员、验证员代理 * 选择型号配置文件（质量/平衡/预算） * 更新 `.planning/config.json` 用法：`/kata-configure-settings` **`/kata-set-profile<配置文件>`** Kata 代理的快速切换模型配置文件。 *“质量”——除了验证之外，作品无处不在 * `balanced` — Opus 用于规划，Sonnet 用于执行（默认） *“预算”——用于写作的十四行诗，用于研究/验证的俳句用法：`/kata-set-profile 预算` ### 实用技能 **`/kata-help`** 显示此技能参考。 **`/kata-whats-new`** 查看自您安装的版本以来发生了什么变化。 * 显示已安装版本与最新版本的比较 * 显示您错过的版本的变更日志条目 * 突出显示重大变化 * 落后时提供更新说明用法：`/kata-whats-new` ## 文件和结构 .规划/ ├── PROJECT.md # 项目愿景 ├── REQUIREMENTS.md # 带有 REQ-ID 的范围需求 ├── ROADMAP.md # 当前阶段细分 ├── STATE.md # 项目记忆和上下文 ├── MILESTONES.md # 完成的里程碑历史 ├── config.json # 工作流程模式和入口 ├── templates/ # 模板覆盖（自定义输出格式） ├── Research/ # 领域研究（来自项目初始化） ├── issues/ # 捕获的想法和任务 │ ├── open/ # 等待解决的问题 │ └── done/ # 已完成的问题 ├── debug/ # 活动调试会话 │ └──已解决/ # 已解决的问题已存档 ├── codebase/ # 代码库地图（棕地项目） │ ├── STACK.md # 语言、框架、依赖 │ ├── ARCHITECTURE.md # 模式、图层、数据流 │ ├── STRUCTURE.md # 目录布局、关键文件 │ ├── CONVENTIONS.md # 编码标准、命名 │ ├── TESTING.md # 测试设置、模式 │ ├── INTEGRATIONS.md # 外部服务、API │ └── CONCERNS.md # 技术债务，已知问题 ├── Milestones/ # 存档的里程碑详细信息 ├──quick/ # 快速的任务计划和总结 │ └── NNN-slug/ │ ├── 计划.md │ └── 摘要.md └── 阶段/ ├──待定/#阶段尚未开始 │ └── 03-下一阶段/ │ └── 03-01-PLAN.md ├── active/ # 当前正在执行的阶段 │ └── 02-进行中/ │ ├── 02-01-PLAN.md │ └── 02-01-SUMMARY.md └── 已完成/ # 已完成阶段 └── 01-基础/ ├── 01-01-PLAN.md └── 01-01-SUMMARY.md ## 工作流程模式在 `/kata-new-project` 期间设置： **互动模式** * 确认每一项重大决定 * 在检查站暂停等待批准 * 更多指导 **YOLO模式** * 自动批准大多数决定 * 不经确认就执行计划 * 仅在关键检查站停靠通过编辑“.planning/config.json”随时更改 ## 规划配置配置如何在“.planning/config.json”中管理规划工件： **`planning.commit_docs`**（默认值：`true`） * `true`：规划提交到 git 的工件（标准工作流程） *“false”：规划工件仅保留在本地，未提交当 `commit_docs: false` 时： * 将“.planning/”添加到“.gitignore”中 * 对于 OSS 贡献、客户项目或保持规划保密很有用 * 所有计划文件仍然正常工作，只是没有在 git 中跟踪 **`planning.search_gitignored`**（默认值：`false`） * `true`: 将 `--no-ignore` 添加到广泛的 ripgrep 搜索中 * 仅当 `.planning/` 被 gitignored 并且您希望项目范围的搜索包含它时才需要配置示例： { “计划”：{ “commit_docs”：假， “search_gitignored”：正确 } } ## 常见工作流程 **开始一个新项目：** /kata-new-project # 统一流程：提问→研究→需求→路线图 /清除 /kata-plan-phase 1 # 创建第一阶段的计划 /清除 /kata-execute-phase 1 # 分阶段执行所有计划 **休息后恢复工作：** /kata-track-progress # 查看您上次停下的位置并继续 **添加紧急的中期里程碑工作：** /kata-insert-phase 5“关键安全修复” /kata-计划-阶段 5.1 /kata-执行阶段 5.1 **完成里程碑：** /kata-complete-milestone 1.0.0 /清除 /kata-add-milestone # 开始下一个里程碑（质疑→研究→需求→路线图） **在工作中捕捉想法：** /kata-add-issue # 从对话上下文中捕获 /kata-add-issue 修复模态 z-index # 使用明确描述进行捕获 /kata-check-issues # 审查并解决问题 /kata-check-issues api # 按区域过滤 **调试问题：** /kata-debug "表单提交失败，静默" # 启动调试会话 # ...调查发生，上下文填满... /清除 /kata-debug # 从上次中断的地方继续 ## 获取帮助 * 阅读 `.planning/PROJECT.md` 了解项目愿景 * 阅读 `.planning/STATE.md` 了解当前上下文 * 检查 `.planning/ROADMAP.md` 以了解阶段状态 * 运行“/kata-track-progress”来检查你的进度

说帮助

包含技能