lazygophers/plugins/tools/trellisx/skills/trellisx-workspace
plugins/tools/trellisx/skills/trellisx-workspace/SKILL.md
--- name: trellisx-workspace description: 维护 `.trellis/task.md` 任务看板 —— trellis 缺的跨任务总览。**一个表格, 一行一个任务**, 列为 id/名称/描述/状态/阶段/进度/worktree (状态/阶段中文显示)。在 task create/start/阶段切换/archive 后**及时更新**对应行; 并**自动清理超 7 天的已完成行**防膨胀。保持看板与 task.json 实时一致。 when_to_use: 维护 / 创建 / 更新 `.trellis/task.md` 任务看板时; task 生命周期任一节点 (create/start/阶段推进/archive) 之后同步看板时; 用户问"当前有哪些任务 / 任务进度 / 任务看板"时。被 trellisx-flow 与 trellisx-apply 注入的流程引用。 user-invocable: true argument-hint: [show|update|sync|cleanup ...] [task id] arguments:
$ install --global
skillsauthnpx skillsauth add lazygophers/ccplugin plugins/tools/trellisx/skills/trellisx-workspaceInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Jun 13, 2026, 7:40 AM144.5s4 files scanned
SKILL.md
- name:
- trellisx-workspace
- description:
- 维护 `.trellis/task.md` 任务看板 —— trellis 缺的跨任务总览。**一个表格, 一行一个任务**, 列为 id/名称/描述/状态/阶段/进度/worktree (状态/阶段中文显示)。在 task create/start/阶段切换/archive 后**及时更新**对应行; 并**自动清理超 7 天的已完成行**防膨胀。保持看板与 task.json 实时一致。
- when_to_use:
- 维护 / 创建 / 更新 `.trellis/task.md` 任务看板时; task 生命周期任一节点 (create/start/阶段推进/archive) 之后同步看板时; 用户问"当前有哪些任务 / 任务进度 / 任务看板"时。被 trellisx-flow 与 trellisx-apply 注入的流程引用。
- user-invocable:
- true
- argument-hint:
- [show|update|sync|cleanup ...] [task id]
- arguments:
- [操作 — show 查看看板 / update <tid> 改阶段·进度·worktree / sync <create|start|archive> 从 task.json 同步 (hook 用) / cleanup 清理超 7 天已完成] [任务 id]
trellisx-workspace — .trellis/task.md 任务看板维护
trellis 原生有每任务 task.json, 但无跨任务总览。本 skill 维护 .trellis/task.md 作为人类可读的任务看板 —— 一个表格, 一行一个任务, 并保证它随 task 生命周期及时更新 (不是写一次就烂掉)。无活动详情块、无子任务树、无归档分区。
文件定位
- 路径:
.trellis/task.md(仓库内, 随 git 版本化) - 角色: 单表格任务看板, 每行一个 task (含已完成, 用状态列区分)
- 数据源:
task.py list/ 各 task 的task.json—— task.md 是其人类可读投影, 冲突时以 task.json 为准 - 维护者 (按列分工, 不冲突):
- ① trellis 生命周期 hook (
trellisx-taskmd.py, 由 trellisx-apply 注入 config.yaml): 自动维护确定性列 (ID/名称/描述/状态) + create/start/archive 时 upsert + archive 时7 天清理。这是硬保障, 不靠 AI 记。 - ② AI (本 skill): 维护主观列 (阶段 实施↔检查 / 进度 / worktree 路径), 在阶段推进时更新。
- hook upsert 时保留 AI 列, AI 更新时保留 hook 列 —— 同行不同列, 互不覆盖。
- 项目未跑 apply (无 hook) 时, AI 全列维护 (含清理)。
- ① trellis 生命周期 hook (
维护时机 (及时更新, 不可滞后)
一律经 .trellis/scripts/trellisx-taskmd.py 脚本操作, 禁直接编辑 task.md 文件 (保证格式一致 + hook/AI 列分工不打架)。
| 触发 | 命令 (脚本) | 谁执行 |
| --- | --- | --- |
| task.py create | taskmd.py sync create | hook (after_create) 自动 |
| task.py start | taskmd.py sync start | hook (after_start) 自动 |
| 阶段推进 (实施→检查→收尾) | taskmd.py update <tid> --phase 检查 --progress 80% | AI |
| worktree 建好 | taskmd.py update <tid> --worktree <路径> | AI |
| task.py archive | taskmd.py sync archive (含 7 天清理) | hook (after_archive) 自动 |
| 查看看板 / 某任务 | taskmd.py show [tid] | AI / 用户 |
| 手动清理 | taskmd.py cleanup [--days N] | AI |
原则: task.md 落后于 task.json = 看板失效。hook 自动管确定性列, AI 在阶段推进时
update主观列。 无 hook 的项目 (未跑 apply): AI 用sync create/start/archive手动触发同步 +cleanup清理。
用法
- 查看 —
python3 .trellis/scripts/trellisx-taskmd.py show [tid]。 - 更新主观列 (阶段/进度/worktree) —
python3 .trellis/scripts/trellisx-taskmd.py update <tid> --phase <P> --progress <N> --worktree <W>。 - 确定性列 + 清理 — 由 hook 的
sync自动 (apply 已注册 config.yaml hooks); 无 hook 时 AI 显式调sync/cleanup。
脚本是 task.md 唯一写入口。脚本不存在 (项目未跑 apply 复制脚本) → 提示用户先
/trellisx-apply, 或按references/模板临时手维护。
参考集
| 文件 | 用途 |
| --- | --- |
| references/task-md-template.md | task.md 单表格模板 (一行一任务) |
| references/dimensions.md | 表格各列字段定义、取值、来源、更新时机 |
| references/maintenance.md | 幂等更新算法 (按 id 定位表行, 从 task.json 同步, 不堆叠) |
边界
- 只维护
.trellis/task.md, 不改 task.json / workflow.md / 源码 - 与 trellis 原生不冲突: task.json 是真值, task.md 是投影; 二者不一致时以 task.json 重建 task.md
- 语言跟随设备/项目语言 (同 trellisx-apply i18n 立场)
Related Skills
lazygophers/trellisx-flow
testing
VerifiedTrustedCommunity
强制以 Trellis task 闭环处理用户指定的请求 (自判新建/并入 → plan→exec→check→finish 全程不跳步)。**仅用户显式主动调用** (/trellisx-flow 或明确要求"强制走 task 处理这个"); **禁止自动 / 被动 / 推断式调用** —— 不要因为某个请求"看起来该建 task"就自动触发本 skill, 那是 apply 注入的 no_task 倾向的职责。
4SKILL.mdUpdated Jun 13, 2026
lazygophers/trellisx-apply
testing
VerifiedTrustedCommunity
把 强推task + subtask拆分 + worktree隔离 + 闭环收尾 四维度增量注入当前项目 .trellis/ (workflow.md 的 no_task/planning/in_progress 块 + spec 背书文档 + trellis 生命周期 hook worktree 自动化)。强推 task 与闭环为纯 prompt 软约束 (非平台 hook 硬拦截)。**纯增量追加, 绝不替换 trellis 原生文本** (no_task 分类+征同意/check/finish/前缀全保留)。幂等 (marker 包裹)。
4SKILL.mdUpdated Jun 11, 2026
lazygophers/cortex-history-digest
development
VerifiedTrustedCommunity
Claude Code 会话历史整理 — 扫 ~/.claude/projects/**/*.jsonl 全部 session transcripts, 提取学习增量 (用户校正/决策/踩坑/L0 规则) → 全局记忆库 ~/.cortex/.wiki/memory/. 默认 --apply 落盘 (--dry-run opt-in 仅出 JSON plan 预览). 与 cortex-extract (L4-inbox 内部) 互补.
4SKILL.mdUpdated Jun 11, 2026
lazygophers/cortex-extract
tools
VerifiedTrustedCommunity
extract/提取/promote/整理/归档/digest L4-inbox 收件箱, 按三轴 (抗遗忘度/强度/复用面) 路由到 L1-long/L2-mid/L3-short/项目/领域, 默认 --apply 落盘 + 增量游标 (--dry-run opt-in 仅出 JSON plan 预览). 触发词: 整理 inbox / 提取记忆 / 归档笔记 / promote / digest.
4SKILL.mdUpdated Jun 11, 2026