关于 html-plan
html-plan 是一项技能,可将源材料整理为可追溯、可执行的单个响应式 HTML 文件。它面向需要保留承诺、顺序和术语,并区分决策、假设与未决问题的计划编写者。
主要功能
- 01保留源材料范围与承诺
- 02整理阶段、负责人、依赖项和风险
- 03区分决策、假设与待解问题
- 04生成响应式且易访问的 HTML
- 05检查宽屏和窄屏布局
适用场景
- 01将项目笔记转为可执行计划
- 02清晰呈现依赖关系和负责人
- 03将计划发布为独立 HTML 文件
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ plannotator/ effective-html --skill html-plan安装后在 Claude Code 中输入/html-plan确认已加载。
附带文件agents/openai.yaml
详细介绍
HTML 计划
将源材料整理为一份便于查阅和执行的计划。除非用户要求进行更广泛的综合,否则应保留用户的范围、顺序、承诺和术语。
围绕工作内容组织文档
在设计之前,先阅读对话、项目说明和所提供的计划。如果已有设计语言,请与其保持一致;否则,根据受众和主题确定简洁务实的方向。
如果有 design-artifact,请阅读其基础原则,让设计方向更明确。本技能中的可追溯性和保留源内容规则具有最高优先级;创意设计不得将计划扩展成仪表板或活动页面。
确定计划实际需要包含哪些内容:
- 阶段或顺序;
- 状态和决策节点;
- 负责人和协作者;
- 依赖关系和风险;
- 验收检查;
- 未解决的问题。
除非源材料提供依据,否则不要添加时间线、进度百分比、状态徽章或仪表板摘要。改进语法和结构,但不要将实施计划扩展为战略文档。
保持可追溯性
- 保留易于辨认的源材料承诺。
- 将已接受的决策与假设和待解问题区分开来。
- 仅在确有依据时呈现顺序和依赖关系。
- 对精确映射、比较或重复字段使用表格。
- 保持长篇内容易于阅读,不要强行将每段内容都放进卡片。
- 仅当流程图或时间线能显著提升顺序的可理解性时才使用。
构建并验证
交付一个响应式、无障碍且自包含的 HTML 文件。使用语义化标题、列表、表格和地标元素。将必要的 CSS 和 JavaScript 内联,避免使用外部服务,并确保所有导航或内容展开功能都可通过键盘操作。
在宽屏和窄屏下检查结果。确认没有遗漏任何承诺,各阶段仍按预期顺序排列,负责人和依赖关系清晰易懂,长内容不会溢出。
返回绝对路径,并说明你引入的任何结构性解读。
评论
支持 Markdown