Files
playbook/skills
cshandClaude Fable 5 2e8c46e152 📝 docs(tsl-syntax-reference): document verified facts from FAQ corpus
从 FAQ 语料(2018 篇镜像)与参考页做完 169 条逐条差集,补入 6 组此前未收录的语言
事实。每条先用 TSL.exe 实跑观察行为,再收敛成 39 条断言的回归门,在 TSLGen2、
AnalyseNG.NET、TSL 三个解释器上均通过后才写入。

- 16 页:0/0 得 nan、2/0 得 inf;nan 的 = > < >= <= 恒假而 <> 为真;nan 沿算术
  传播;nil 在乘除减里按 0 参与
- 04 页:整体赋值免声明,但对未建立的变量写单元格赋值会报「变量类型不是Array」
- 07 页:相邻两个 if 是两条独立语句都会执行;for..in 单控制变量拿到的是键不是值;
  二维数组按行推进,行本身是数组(新增 syntax-07-013)
- 21 页:子矩阵赋值语句求值为 0;t[:,:] 按位置复制不按列名对齐(新增
  syntax-21-019);| 列并时同名字符串列键由右操作数覆盖(新增 syntax-21-018)
- 13 页:select 输出列表同名列后者覆盖前者,须用 as 改名(新增 syntax-13-032)

三条 FAQ 说法实跑不复现,故未写入:12574 的括号消歧、19857 的 -2147483648
字面量限制、31474 的 :. bugfix 记录。15305/11045 的用户/公用/共享函数同名解析
优先级需要服务端多账号环境,本地无法验证,仍为已知缺口。

lexicon.json 为 16 页补两个页级 alias,使 nan/nil 语义能被自然语言查询命中。

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-20 20:58:10 +08:00
..

Skills Overview

本目录包含 Playbook 提供的 AI agent skills,分为两类:

  • 一方 skills:本仓库维护(skills/<name>/
  • 第三方 skills:同步自外部来源(skills/thirdparty/<name>/

安装与使用详见 SKILLS.md

一方 Skills

Skill 作用 典型场景
commit-message 根据 staged diff 生成符合仓库规范的提交信息,并判断是否应拆分提交 写 commit message、检查 staged 改动是否适合一个提交
gitea-fix-ci 基于 Gitea Actions run/job/log 诊断失败 CI,先形成修复计划再改代码;含 fetch_ci_logs.py 取证脚本 Gitea PR checks 失败、远端 CI 红但本地需要定位
cook-it-through 运行任务路由、Matt 工程主链和本地 Markdown ticket 生命周期 处理实质性工程任务,或操作 .scratch queue、claim、finish、integrate
tsl-syntax-reference 查询 TSL 语法条目,验证具体写法和错误边界;不负责 API、命名、风格、工具链或模块集成 写/改/审 TSL 时确认语言结构、表达式、控制流、对象模型和语法限制
tsl-api-reference 查询 TSL API、class/framework 契约和天软数据字典;按 workflow 路由并由脚本 help 定义调用契约 确认 API/成员/回调的签名和示例,或按中文业务含义查表、数据源与字段

第三方 Skills

Matt Pocock Engineering Workflow

正式工程主链来自 mattpocock/skills,使用本地 Markdown tracker 和 ticket DAG。

Skill 作用
setup-matt-pocock-skills 配置 tracker、领域文档和 agent 入口
grill-with-docs / grilling 收敛 design tree 并同步领域词汇/ADR
to-spec 把已确认上下文合成为 feature spec
to-tickets 拆成带 blocking edges 的 tracer-bullet tickets
tdd 在约定 seam 上按 ticket 采用测试驱动实现和验证
code-review 对固定点后的提交做 Standards/Spec 双轴审查
handoff 跨 session 交接未完成上下文

安装时使用 mode = "all",或在 skills 中逐项列出主链、cook-it-through 及其依赖; 安装器不推导 skill 依赖。cook-it-through 同时定义工程和本地 ticket 协议,并由其内部 执行引擎强制执行状态机。

brooks-lint Suite

Code review 和质量审查工具集,包含共享参考资料目录 _shared

Skill 作用
brooks-review 常规 PR / diff code review
brooks-audit architecture audit、系统性结构问题审查
brooks-debt technical debt review
brooks-health 项目健康度检查
brooks-sweep 扫描式问题发现
brooks-test 测试质量审查

代码库侦察与迁移

Skill 作用
codebase-recon 通过 git 历史和代码结构做 risk scan、热点分析、重构前侦察

其他

Skill 作用
ui-ux-pro-max UI/UX 设计知识库,包含风格、配色、字体、组件和栈相关建议
cangjie-skill 将书籍、课程、访谈等长内容蒸馏为原子化、可执行的 skills
darwin-skill 评估并迭代优化 skills,以测试提示和成对评审控制质量回归