xyaz1313/xyskill / skills/xy-dispatch
xy-dispatch
Verified【派单】把一件事交给团队里的真人去做:读对方资料选人、写清楚目的/交付物/验收标准/截止时间,派出去之后接收对方的接单/提问/进度/提交,按原定标准验收,向你汇报谁在干什么、卡在哪、要不要你决定。用户说「这个交给小王」「派给谁合适」「他回复了帮我看看」「他交了验收一下」「帮我写个任务说明」时使用。不做招聘、不做绩效排名、不生成惩罚。|小爷出品
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 11.2 KB |
| agents/openai.yaml | config | 294 B |
| evals/evals.json | config | 1.8 KB |
| scripts/dispatch.py | script | 6.2 KB |
| scripts/test_dispatch.py | script | 5.9 KB |
scripts/dispatch.py
View on GitHub#!/usr/bin/env python3
"""xy-dispatch 本地任务状态机:人员派单记录与状态流转校验。
不触碰飞书;飞书实际读写由对话中调用 lark-doc/lark-im 完成。
"""
import argparse
import json
import re
import shutil
import sqlite3
import sys
import time
from pathlib import Path
TRANSITIONS = {
'draft': {'assigned', 'cancelled'},
'assigned': {'accepted', 'declined', 'blocked', 'submitted', 'cancelled'},
'accepted': {'in_progress', 'blocked', 'submitted', 'declined', 'cancelled'},
'in_progress': {'blocked', 'submitted', 'declined', 'cancelled'},
'blocked': {'accepted', 'in_progress', 'submitted', 'needs_owner', 'declined', 'cancelled'},
'submitted': {'passed', 'needs_revision', 'needs_owner', 'declined', 'cancelled'},
'needs_revision': {'in_progress', 'blocked', 'submitted', 'cancelled'},
'needs_owner': {'in_progress', 'needs_revision', 'passed', 'declined', 'cancelled'},
'passed': set(), 'declined': set(), 'cancelled': set(),
}
REQUIRED_FIELDS = ('owner', 'assignee', 'goal', 'due', 'timezone', 'feedback', 'authorization')
LIST_FIELDS = ('deliverables', 'acceptance', 'materials')
def emit(obj):
print(json.dumps(obj, ensure_ascii=False))
def default_dir():
return Path.home() / '.xy' / 'dispatch'
def connect(root):
root.mkdir(parents=True, exist_ok=True, mode=0o700)
db = sqlite3.connect(root / 'state.sqlite3', timeout=10)
db.row_factory = sqlite3.Row
db.executescript('''
CREATE TABLE IF NOT EXISTS tasks(id TEXT PRIMARY KEY, data TEXT NOT NULL);
CREATE TABLE IF NOT EXISTS history(id INTEGER PRIMARY KEY, task_id TEXT, at REAL, data TEXT);
''')
db.commit()
return db
def load_task(db, ident):
row = db.execute('SELECT data FROM tasks WHERE id=?', (ident,)).fetchone()
if not row:
raise ValueError('unknown task: ' + ident)
return json.loads(row['data'])
def validate_task(data):
if not re.fullmatch(r'[A-Za-z0-9_-]{1,100}', data.get('id', '')):
raise ValueError('invalid task id')
for field in REQUIRED_FIELDS:
if not data.get(field):
raise ValueError('missing field: ' + field)
for field in LIST_FIELDS:
value = data.get(field)
if not isinstance(value, list):
raise ValueError(field + ' must be an array')
if field != 'materials' and not value:
raise ValueError(field + ' must not be empty')
if data.get('mode') not in ('text', 'on_demand'):
raise ValueError('mode must be text or on_demand')
def cmd_register(db, args):
data = json.loads(args.task_file.read_text(encoding='utf-8'))
validate_task(data)
if data.get('state', 'draft') != 'draft':
raise ValueError('new task must start in draft')
data['state'] = 'draft'
try:
db.execute('INSERT INTO tasks VALUES(?,?)', (data['id'], json.dumps(data, ensure_ascii=False)))
except sqlite3.IntegrityError:
raise ValueError('task id already registered: ' + data['id'])
db.commit()
emit({'task_id': data['id'], 'state': data['state']})
def cmd_revise(db, args):
data = json.loads(args.task_file.read_text(encoding='utf-8'))
validate_task(data)
old = load_task(db, data['id'])
if old['state'] in ('passed', 'declined', 'cancelled'):
raise ValueError('terminal task cannot be revised; register a new task instead')
for field in ('assignee', 'owner'):
if old.get(field) != data.get(field):
raise ValueError(field + ' cannot change; register a new task instead')
data['state'] = old['state']
db.execute('UPDATE tasks SET data=? WHERE id=?', (json.dumps(data, ensure_ascii=False), data['id']))
db.execute('INSERT INTO history(task_id, at, data) VALUES(?,?,?)',
(data['id'], time.time(), json.dumps({'revision_before': old, 'revision_after': data}, ensure_ascii=False)))
db.commit()
emit({'task_id': data['id'], 'state': data['state']})
def cmd_transition(db, args):
if not args.evidence.strip():
raise ValueError('evidence cannot be blank')
data = load_task(db, args.task_id)
old_state = data['state']
if args.to not in TRANSITIONS[old_state]:
raise ValueError('invalid transition: ' + old_state + ' -> ' + args.to)
data['state'] = args.to
db.execute('UPDATE tasks SET data=? WHERE id=?', (json.dumps(data, ensure_ascii=False), args.task_id))
db.execute('INSERT INTO history(task_id, at, data) VALUES(?,?,?)',
(args.task_id, time.time(), json.dumps({'from': old_state, 'to': args.to, 'evidence': args.evidence}, ensure_ascii=False)))
db.commit()
emit(data)
def main():
parser = argparse.ArgumentParser(description=__doc__)
parser.add_argument('--state-dir', type=Path, default=None)
sub = parser.add_subparsers(dest='command', required=True)
sub.add_parser('doctor')
sub.add_parser('init')
sub.add_parser('tasks')
for name in ('register', 'revise'):
p = sub.add_parser(name)
p.add_argument('--task-file', type=Path, required=True)
tr = sub.add_parser('transition')
tr.add_argument('--task-id', required=True)
tr.add_argument('--to', choices=sorted(TRANSITIONS), required=True)
tr.add_argument('--evidence', required=True)
args = parser.parse_args()
root_expanded = (args.state_dir or default_dir()).expanduser()
root = root_expanded.resolve()
if args.command == 'doctor':
emit({'state_dir': str(root_expanded), 'exists': root.is_dir(),
'lark_cli': shutil.which('lark-cli'),
'auth_verified': False, 'mode_available': ['text', 'on_demand']})
return
db = connect(root)
try:
if args.command == 'init':
emit({'initialized': str(root)})
elif args.command == 'tasks':
emit([json.loads(r[0]) for r in db.execute('SELECT data FROM tasks ORDER BY id')])
elif args.command == 'register':
cmd_register(db, args)
elif args.command == 'revise':
cmd_revise(db, args)
elif args.command == 'transition':
cmd_transition(db, args)
finally:
db.close()
if __name__ == '__main__':
try:
main()
except (ValueError, OSError, sqlite3.Error) as exc:
emit({'error': type(exc).__name__, 'detail': str(exc)})
sys.exit(1)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |