agentleFS
comkocscomkocs/md-workflow/.agents/skills/short-book-drafting/SKILL.md

short-book-drafting

Skill3 starsChanged 8 days agoApache-2.0View on GitHub

给甲类大型工单起草五块短书、明确判据与改动白名单,并把轻闸工序和六条派遣提示交给施工主窗(回退线上交执行员)时使用。单窗用短书;只有并线冲突、跨仓或触发回退条件时才改走双窗。

The file

Files
SKILL.md

这个 skill 是干什么的(人话)

这个 skill 帮你把大型工单写成五块短书,再把执行边界和交接要求交清楚。总监定要什么、怎么算完成、只许改哪里;施工主窗自己编排施工,避免任务书越写越长却漏了关键口径。甲类大型仍用短书 + 轻闸,由总监主窗直派施工员 / 读件员 / 审计员(单窗);执行员(困难档子代理或独立窗)只在回退线触发后用。回退线 = 并线冲突、跨仓或第 3 节第 5 条的回退条件。

分类

分类:单独装即可用

用前填这几个名字

  • {{拍板人}}:决定需求、档位映射与回退的人。
  • {{工单台命令}}:你们现有工单工具的命令入口;没有对应工具时,先约定等价的人工登记办法,不把占位命令当成可运行命令。
  • {{代码仓路径}}、{{工作树根目录}}:代码仓与独立施工树的根目录。
  • {{代码托管远端}}、{{远端主支}}:取代码用的远端和完整主干引用,例如 origin、origin/main。
  • 单号、施工主窗(回退线上为执行员)、平台、工作树、分支、交版或上服去向、底数提交、证据存放位置:全部填本单实值,不抄示例。

什么时候用

  • 预计改动不少于 1,500 行或跨不少于 10 个文件,需要起草甲类大型工单。
  • 单窗承担整单,需求已定,需要把口径、判据和边界一次交给施工主窗;回退线上交执行员。
  • 发生并线冲突或跨仓,需要明确双窗交接;短书不是绕过回退条件的理由。

步骤

1. 先定边界,不替施工主窗编排

总监本体起草,不把起草再派出去。先确认依赖头、同期单的改面交集、单窗或双窗、交版或上服。只用顶级、困难、日常、轻量四档词,不写具体模型名:顶级由主窗自做;困难承担复杂施工、完整审计与起草;日常承担普通施工与轻审;轻量承担扫盘读件。子代理档位与模型照本项目模型对照表实填列,拍板人改口走当日口径。

2. 照五块填短书

读 references/短书骨架.md,首行填单号、主题、甲类大型、短书、施工方(总监主窗直派或回退线上执行员)与实际日期;正文只写下面五块。

  1. §一 出题:一段事实与裁定出处;写流程、平台、执行员档位(仅回退线;未触发写无)、交版或上服去向。列同期单交集、谁先谁后与依赖头,没有交叉就明确写没有。
  2. §二 已定口径:逐条写全拍板人与别位已经谈定的口径;接口说清谁给什么、何时给。下级(含回退线执行员)看不到总监上下文,不能靠暗示补齐。
  3. §三 判据与改动面:每条都有检法与期望输出;逐个点名允许改的路径,范围外停在边界回报。明确不验什么及理由,下级不得自改判据。
  4. §四 底数件路径:按文件、行号、基点提交列线索;基点是开工主干头。用前复核,漂行按新行号做并记偏离,不把旧底数当事实。
  5. §五 并线去向、审计档位、未验项口径:写工作树、分支、推哪支、交版或上服,引用轻闸工序;写完整审计或轻审及其档位依据,列未验项与逐条偏离。

不要在五块里加串行施工脚本。先做哪节、派哪档、命令怎么写,由施工主窗写进进度件第一笔,写完再开工。

3. 把六条派遣提示一起交给施工主窗(回退线上交执行员)

  1. 等待:长工具调用改后台运行;后台子代理做完自动通知,主窗不轮询、不挂计时器;只有平台不通知时才每次 sleep 180~240秒,醒来查进度、处理下级问话再等;不把多次 sleep 包成一次长时间前台调用。只为实际互斥的部署动作反复等,不为别单状态空等。
  2. 交接:下级满 2 次压缩且手头单收完,先把已做、未做、证据位置和下一步写成交接件,收口回报,再换新下级读件接力;主窗、回退线上的执行员也照此办理。已交回结果的下级空闲超过 5 分钟,不续派新活给旧下级。
  3. 回报三行:第一行写结果与提交号;第二行写判据结果和原样输出位置;第三行写未做、偏离或阻塞。没有产出的不写成已经完成,长日志只给位置。
  4. settle 取数:在收口三问之后记书挂出到收口的总挂钟、审计结论(完整审计五计数或轻审四样 x/4)、总监窗起步和收窗 token 数及其增量、同位对照单,以及派了哪些子代理、各什么档。平台侧子代理折价与书层花费交效率审查员从会话 usage 计算,不自编数;取不到的写未取得。
  5. 回退:预计长单且总监执行期间要换窗、总监满 2 次压缩且手头单收完、幻觉返工或断线续不上、拍板人要求回双窗,任一成立就把该单回退为双窗。需要起客户端本身不触发回退,由施工主窗按任务书办理;总监要亲看时先交计划。
  6. 作废句:旧提示中与现行四档分工冲突的分层说明作废;额外核验并入审计,必要核项仍保留;「串行步骤前台派下级」的长等要求作废,不因前台等待绕过本节的后台与交接规则。

4. 交付轻闸,不代替施工主窗做工序

把短书和 references/轻闸骨架.md 一起交给施工主窗;回退线上交执行员,指出本单照做的节与偏离项。轻闸覆盖起手、施工、并线、独立审计、收口、上服与 settle、交集、不做、未核清单;任务书写死的优先,差异逐条记进收口报告。

  • 施工主窗先写进度件第一笔,再按白名单施工;只跑任务书规定的构建与点名检查,完整套留到并线组合树。
  • 施工主窗不自审,审计独立进行。审计件至少写「核了什么」「问题与结论」两节,并附任务书要求的计数。
  • 收口报告四块:做了什么与并线号、判据逐条自核、未做与偏离、要拍板人答的;全文不超过 6,000 字,收尾三问不超过 300 字,再附 settle 取数。
  • 只保留进度件、收口报告、总监派的审计件,可选再一件,合计不超过四件。没有上服就明确写不适用,不凭空执行部署。

5. 发出前逐项核

五块是否齐、判据能否真跑、白名单是否逐个点名、底数是否带提交、同期交集是否定先后、审计与未验项是否写清、六条是否一起交付。单号、裁定号由各自授权入口产生,不在短书里自造编号。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.