关于 to-prompt
将软件任务整理为供接收任务的 LLM 使用的精简实施说明。它要求依据实际证据描述现状、保留已批准的约束,并留下未决设计选择。
主要功能
- 01判断任务类型
- 02收集代码与运行证据
- 03创建带时间戳的说明文件
- 04保留已批准约束
- 05记录重要未知事项
适用场景
- 01交接故障修复任务
- 02准备改进需求说明
- 03为 LLM 界定新功能范围
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ marcioaltoe/ skills --skill to-prompt安装后在 Claude Code 中输入/to-prompt确认已加载。
附带文件assets/brief-template.md
详细介绍
提示词说明
撰写一份简短的说明,而不是解决方案。这份说明应包含接收方大模型自行选择实现方案所需的一切信息——问题、当前状态、要求和约束——并保留用户已提供的任何实现约束或已批准方案。将尚未确定的设计选择留给接收方;不要为了把问题变成开放式问题而抹去已接受的决策。
每份说明都是一个文件:docs/prompts/<YYYYMMDD-HHmm>_<slug>.md(例如,docs/prompts/20260709-1745_fix-auth-redirect.md)。
步骤
- 分类任务——判断任务属于缺陷修复、改进还是新功能,并起草一段话,说明问题和预期结果。
- 收集证据。 阅读相关代码路径;引用当前实际存在的代码;摘录相关错误或日志内容,并排除凭据和无关的私人数据;记录环境和近期变更。完成标准: 说明中的每项陈述都有你实际阅读或运行所得内容作为依据。
- 根据模板撰写说明。 将
assets/brief-template.md复制到docs/prompts/<YYYYMMDD-HHmm>_<slug>.md(若目录不存在则创建;slug = 小写、以连字符分隔的摘要;时间戳 = 当前时间)。填写适用部分并删除指导性注释。记录影响重大的未知事项;省略不相关部分。 - 检查决策保真度。 区分用户批准的约束、建议和未解决的选择。保留用户要求的结果和授权;避免引入新的实现要求。
- 交接。 回复文件路径,并用一句话概述说明的要求。
随附文件
assets/brief-template.md— 说明的框架和各类型任务的内容覆盖指南;它是完整说明内容的唯一事实来源。
评论
支持 Markdown