ask-claude 处理的是同一个问题的两种问法:一是“用户无法注册”这类需要明确工作方式(是否先复现、如何证明修复)的编码任务;二是“每次编辑后运行 rubocop”这类需要特定功能(写在 CLAUDE.md 里只是建议性、钩子则每次都执行)的配置任务。无论哪种,最终都产出一份用户批准后才运行的提示词。
工作流程分为五步。第一步是查看(Look):以任务为输入(取自 $ARGUMENTS 或向用户索取),浏览 README、路由、任务涉及的区域和近期提交,找出提示词可引用的具体文件、可复制的模式、覆盖该任务的测试和检查命令;同时检查已有的 CLAUDE.md、.claude/settings.json 钩子、.claude/skills/、.claude/agents/ 及已安装技能,已被现成技能覆盖的任务优先复用。该步骤限定在仓库及其 Claude 配置内,不检索 Slack、邮件等外部连接工具中的上下文,需要时直接询问用户。
第二步是阅读文档(Read the docs):从两个文档索引出发,选取与本任务相关的 2 至 5 个页面阅读,包括 Claude Code 与 Agent SDK(技能、钩子、子代理、工作流、权限模式、MCP、无头运行、设置)和 API、提示工程、工具使用、Managed Agents、模型等页面;多数任务值得读最佳实践、功能概览、提示工程最佳实践,再按任务读钩子指南、工作流或无头运行文档。需保留所依赖页面的 URL,抓取失败时必须说明并从记忆中补充的内容标注来源。
第三步是提问(Ask):一轮内只问代码和文档无法回答的内容,包括实际发生了什么(谁、看到什么、从何时起,优先粘贴错误、工单、日志)、应该发生什么、完成的标准是什么(诊断报告还是修复、个人使用还是通过git 给全团队)。“不知道”也可接受,会作为未知项写入提示词。
第四步是推荐(Recommend):先给方案,再给承载方案的提示词。方案中包含“为什么”(引用或指向官方文档以便用户核查)和“不采用”(列出一两个用户可能想到的替代方案及其缺陷,没有接近的替代方案时省略)。方案不一定是 Claude 功能,若应用已有调度器、Slack 客户端和 LLM gem,“每天早晨发工单摘要”可能更适合做成后台任务,从而获得代码审查、测试和错误追踪。编码任务的提示词按以下要素撰写:明确的请求(修复还是只诊断)、已知信息及其来源(用户、工单、未验证)、查找位置(具体路径)、每条约束背后的原因(避免全大写)、工作方式(先复现再修复、计划模式、子代理)、范围之外的内容、完成标准(写明具体命令如 bin/rspec spec/requests/auth_callbacks_spec.rb 通过)以及无法访问的资源。若其他技能更合适(如未定范围的功能用 /slice、业务流程不清用 /domain-model),则以该技能作为方案。推荐后停止,不运行用户未看过的提示词。
第五步是运行(Run it):批准后按提示词原文在此执行;若有修改则修改后再次展示。若更适合在其他环境执行(大任务用新会话、不清晰的任务用计划模式),应说明并让用户选择,提示词可独立粘贴使用。
该技能可能失败的两处:凭记忆回答导致推荐已改名或遗漏上月新发布的功能;提示词只是把任务换种说法复述,没有增加智能体无法自行推断的信息。此技能为 Claude 使用方式咨询与提示词生成工具,不提供独立产品定价、平台支持或效果保证等信息,相关资料暂未提供。