内置指令

内置指令是 Seed 给 AI 协作准备的“快捷说法”。你不必每次写一大段流程，只要在 AI 执行会话里写 #任务包、#模块地图、#项目记忆 这类短语，AI 就能按仓库里的说明去执行对应流程。

它不是终端命令，也不要求平台账号。它本质上是仓库中的帮助文档、规则和示例，方便人用一句话触发稳定工作流。

调用格式

#关键字：补充说明

博客搜索示例：

#任务包：把博客搜索从前端过滤升级为可恢复任务包，先审计当前列表、数据来源和测试入口，再决定是否需要后端搜索 API。

如果一个短语可能有多种含义，AI 应先确认，不应该猜。

常用指令

指令	适合场景	博客搜索示例
#项目指令	让 AI 先查仓库已有流程，再开始执行。	#项目指令：按当前仓库规则处理博客搜索任务
#任务包	把大任务拆成可恢复、可验证的任务包。	#任务包：为博客文章列表增加搜索、测试和模块档案同步
#跑任务包	执行已有任务包目录或用户提供的任务包文件。	#跑任务包：task-packs/blog-search
#交接任务	把外部讨论或方案整理成 AI 可执行任务。	#交接任务：把这份博客搜索方案转成 AI 任务
#模块地图	初始化、检查或审计项目模块树。	#模块地图：检查博客模块是否覆盖页面、API 和测试入口
#模块发现	证据不足时先登记候选模块。	#模块发现：文章列表页面还不知道是否属于 blog 模块
#项目记忆	把项目长期规则、术语或偏好沉淀到共享文档。	#项目记忆：博客搜索默认匹配标题和摘要
#本机记忆	把本机端口、路径、工具链差异留在 .local/。	#本机记忆：本机博客前端调试入口只写入 .local
#脚本规范	审计或升级 ops/scripts/ 的脚本入口。	#脚本规范：检查博客搜索验证脚本是否有 JSON 输出
#文档索引	为重要文档补写读契约和索引信息。	#文档索引：让博客模块说明可被 AI 稳定读取
#收口格式	要求 AI 用固定格式说明变更、验证、风险。	#收口格式：简洁说明博客搜索变更和检查结果

一次完整使用示例

#任务包：为博客文章列表增加搜索能力

要求：
- 先定位博客模块档案、文章列表页面、数据来源和测试入口。
- 第一阶段只做前端标题 / 摘要搜索。
- 如果审计发现已有后端分页或权限过滤，再把后端搜索列为独立子任务。
- 每个子任务完成后更新 SESSION_STATE.md。
- 完成后运行检查并给出中文收口。

AI 应把这条需求整理成任务包，包含任务说明、计划、执行入口、状态记录和编号任务。后续即使会话中断，也可以用 #跑任务包 继续。

指令和 Prompt Spec 的关系

Prompt Spec 说明“这次具体要做什么”。内置指令说明“这类任务应该按什么流程做”。

推荐组合：

#模块地图：审计博客模块

## 目标
确认博客模块的页面、API、配置、测试入口和文档是否登记完整。

## 验收标准
- 输出缺口清单。
- 不直接删除旧文档。
- 给出博客搜索任务的下一步建议。

常见错误

错误	修正方式
只写 #任务包，没有目标	加一句任务目标和验收标准。
把指令当终端命令运行	指令是给 AI 会话看的，不是 shell 命令。
指令和目标混在一起	第一行写指令，后面写背景、目标、边界和验证。
项目里没有对应说明	先让 AI 说明未找到，再按普通 Prompt Spec 执行。

下一步

阅读 公开示例脱敏检查，把博客搜索任务包整理成可分享示例前先做脱敏和 gate。