weichen
a3859091d7
ci / test (pull_request) Failing after 31s
Why: the previous close commit archived the card but the link edit
landed only in the working tree; the archived copy still had the
placeholder.
Evidence: Dev PR #34 merged as 5c95c5f.
Impact: one-line card fix; no code change.
3.4 KiB
3.4 KiB
feature/prompt-library 任务卡
任务主记录：https://git-home.u1680832.nyat.app:30319/weichen/Agent-System-Dev/pulls/34（merge 5c95c5f）；状态：已完成；owner：weichen
基线与授权
- 权威仓：ssh://git@git-ssh.u1680832.nyat.app:31411/weichen/Agent-System-Dev.git；目标分支：main；R0（initial_base_sha）=
45e6a07626 - 工作区：/home/weichen/projects/Agent-System-Dev-wt-feature-prompt-library（worktree）；分支：feature/prompt-library
- 授权与交付终点：用户批准提示词体系方案并指示施工（"充分纳入可纳入的；总结设计思路供扩展"）→ 完成实现与验证，按自主闭环建 PR 合入
目标与非目标
- 目标：① 提示词从代码移入数据（embed 库文件，frontmatter 格式）；② 分层模型 base/env/task/agent/tool/aux/style 全部纳入（不止日常用到的）；③ 触发匹配（intent/command/attachment/manual + 附件门槛 + 优先级让位）；④ 覆盖链 builtin→user（DB v8 迁移 + API + drift 标记）；⑤ 组装进 ctxasm（多段 system + 可观测）；⑥ 子代理/小队角色/工具文案接线；⑦ 设计思路文档沉淀。
- 非目标：提示词管理 UI（设置界面浏览/编辑——契约与 API 已就绪，UI 另行）；会话压缩/标题生成的功能接线（模板已入库，随远期档）。
同步记录
| 节点 | sync_base_sha | tested_head_sha | checked_at |
|---|---|---|---|
| 启动 | 45e6a07626 |
45e6a07626 |
2026-09-30T10:14:30Z |
结果与验证（完成后填写）
- 结果：
- core 0cb0a40：PromptModule/PromptTrigger/PromptBlock/PromptHitRecord 契约 + AgentProfile.promptModules（引用有序；空=默认 base+env）+ ts/types.ts 镜像。
- backend：internal/prompts 包（最小 frontmatter 解析器含块标量、embed 库、覆盖链服务、触发匹配、ResolveSystem 组装、占位符解析）；40 个内置模块（base 5 + env 1 + task 12 + agent 10 + tool 7 + aux 3 + style 2）；ctxasm 接收多段 system + prompt 观测条目；llm.go 组装接线 + 工具文案库覆盖；SubLLMRunner/squadadapter 角色接库（回退内联）；server /api/prompts CRUD + 技能命令进
/菜单 + postMessage 技能命令跳过命令路由走 run；store v8 迁移 prompt_modules 表；默认画像 SystemPrompt 清空（基座走库）。 - frontend：contracts.ts 镜像（PromptModule + promptModules）+ api.listPromptModules。
- documents：docs/guides/prompt-library-design.md（分层模型、模块设计八法、触发设计、格式命名、覆盖链、组装观测、扩展步骤、反模式）。
- 验证：
make test组合全绿：core ok；backend 17 包 ok（新增 prompts 包 9 组测试：库完整性/默认组装/技能触发（命中·门槛·命令绕过）/优先级让位/画像引用/覆盖链 drift/命令匹配/agent+tool 取用/frontmatter 解析）；frontend 9；ui 23；deps ok。- 运行时验证（mock 后端 8789）：启动加载 40 模块；GET /api/prompts 层分布 5/1/12/10/7/3/2；覆盖保存→basedOnVersion=1→删除恢复内置往返；/api/commands 含 12 个 prompt-skill 命令；
/minutes 关于季度会消息起 run（不走命令总线）。
- 影响与剩余项：提示词管理 UI 未做（API 就绪）；aux 层三个模板未接线（随 SummarizeBeyond/会话管理远期档）；真实模型下的技能注入效果需用户侧验收。