AGENT SKILL
SpecTrail Skill
在编码 Agent 的对话里推进工作。先说明目标和验收条件，再形成方案、拆分任务、执行验证，最后同步 Specs 并归档。
安装与使用 Skill运行在 Agent 中 · 将文档与流程状态写回仓库
Git 中的工程记录 · Agent 的工作流从需求到验收，
从需求到验收，
让每一次改动
都有来路。
SpecTrail 帮助编码 Agent 整理需求、规划任务、记录执行与验收。工程事实留在 Git，你可以通过 OpenFolio 阅读，也可以关联每次改动的设计原型。
Codex / Claude CodeGit + Markdown可按需组合
同一份工程记录
订单导出 Skill · 工程推进
docs/project/
specs/当前能力
changes/export-orders/本次改动
requirement.md目标与验收条件
technical.md方案与取舍
plan.md任务安排
change.json流程状态
archive/已完成的历史
执行中
stage: execution任务与证据一起提交OpenFolio 工作台 · 只读
Specs
Changes
原型
订单导出
读取已推送分支中的任务和验证记录。
需求与方案完成
导出数据完成
浏览器验证进行中
export-orders分支、任务、原型，回到同一份记录订单页面 原型 · 固定版本
订单列表导出 CSV
| 订单 | 金额 | 状态 |
|---|---|---|
| #DEMO-001 | ¥ 280.00 | 已完成 |
| #DEMO-002 | ¥ 148.00 | 待发货 |
| #DEMO-003 | ¥ 620.00 | 已完成 |
示例设计桌面 / iPad / 手机
Change → 固定引用三个模块，各有职责
推进工程、阅读记录、
交付设计。
从 Skill 开始。需要浏览工程记录时接入工作台，需要讨论界面时启用原型管理。
ENGINEERING WORKBENCH
OpenFolio 工作台
在浏览器里阅读工程。连接个人 GitHub token，发现接入 SpecTrail 的仓库，查看当前 Specs、跨分支 Changes 和关联原型。
了解工作台与接入独立部署的 Web 服务 · 只读已推送的工程记录
OPTIONAL PROTOTYPES
原型管理
把页面和组件设计带进工程记录。维护当前原型清单，为 Change 保留固定版本，按设备预览，并分享公开设计链接。
查看原型与发布方式Skill 的可选模块 · 支持托管发布与 Git 单 HTML
Git 保存共同的工程事实。
Skill 维护记录，工作台读取记录，原型引用跟随对应的 Change 保留。
SpecsChangesArchivePrototypes一次改动的经过
从一句目标，到可回看的交付。
- 01
说清楚要做什么
让 Agent 整理目标、范围和验收条件，按任务规模选择合适的流程。
- 02
形成方案与任务
把关键取舍、依赖和验证方式写进方案，拆成能独立验证的任务。
- 03
执行并留下证据
任务状态、代码和实际验证一起提交推送。需要时把原型固定版本关联到 Change。
- 04
验收、同步、归档
确认交付结果，更新当前能力规格，保留完整的改动历史。
Codex · 项目内安装
npx skills add iTgo-lyq/spec-trail --skill spec-trail --agent codex --copy -y在目标 Git 项目根目录执行
Claude Code · 项目内安装
npx skills add iTgo-lyq/spec-trail --skill spec-trail --agent claude-code --copy -y在目标 Git 项目根目录执行
工作台与原型管理可在需要时接入。
开始前，你可能想知道
从一个模块开始，
逐步接入。
只安装 Skill 可以使用吗？
可以。Skill 在编码 Agent 中执行，使用 Git 和项目内文档保存工作流。OpenFolio 提供浏览器阅读入口，原型管理则按需启用。
工作台会替 Agent 修改任务吗？
工作台读取中心 Git 已推送的记录。需求、任务和流程状态由 Agent 在仓库中维护，提交推送后再刷新工作台。
原型和真实业务系统是什么关系？
原型使用示例数据演示页面和组件交互。它为需求讨论与设计验收提供参考；业务实现继续在项目的工程流程中完成。
工程记录和公开原型的权限一样吗？
工程记录按你的 GitHub token 和仓库权限读取。已经发布的原型可以公开分享，准备发布时应使用适合公开展示的内容。
项目迁移后，工程历史如何保留？
Specs、Change 文档和归档随 Git 仓库保留。托管原型的固定版本由对应存储服务保留，Git 兜底的单 HTML 产物随仓库和归档保存。
让下一次改动，从清晰的目标开始。
安装 Skill，告诉 Agent 你想完成什么。