project-workflows
Project Workflows
把绝大多数项目工作收敛成一个统一工作流:先澄清目标,再看现状与约束,选最小可交付切片,必要时拆子问题并行推进,并在过程中调用更专项的 skill。
统一工作流
- 先复述任务:用一句话说清当前要推进的目标,不把多个目标混成一句空泛表述。
- 先补最关键的缺口:若目标、边界、约束、成功标准或最小可行范围仍模糊,先澄清,不急着实现。
- 看现场而不是看理想蓝图:优先读取当前代码、目录、脚本、文档、参考项目或运行状态。
- 选最小可交付切片:优先推进最能降低不确定性、最容易验证价值的一步,而不是一口气铺完整方案。
- 必要时拆子问题:当子问题边界清楚、可独立推进时,显式标出依赖和并行边界。
- 调用专项 skill:技术选型、架构边界、Python 工程化、第三方库文档、经验沉淀等,交给更窄的 skill 处理。
- 交付统一 packet:向用户交付一个可继续推进、可执行、可合并的统一 packet,而不是停留在泛泛建议。
统一 Packet(输出契约)
至少包含:
- Objective:当前要完成什么
More from zrr1999/skills
unix-software-design
适用于软件设计、架构拆分、边界划分、接口规划、复杂度控制等场景。只要任务核心是“怎么把系统设计得更简单、更透明、更可组合”,就应参考。
33tech-preferences
适用于技术选型、架构规划、工具推荐、重构方向判断、开新坑定栈等场景。只要任务里出现“该选什么”“什么更适合我”“要不要换工具/框架”这类问题,就应先使用。
23modern-stack
个人现代化技术栈说明。在进行任何规划或实现功能、搭建项目脚手架、写示例代码或 CI/自动化配置等任务时,优先按照这里提供的内容来思考和生成方案。
13agent-cli-toolkit
终端取证与 CLI 自动化优先:用 rg/fd、bat、sd、delta/difft、http/jq、fzf、hyperfine、dust/duf/procs/btm、gh/gh-llm、x/vp/bun/uv;多窗格/命名会话/长时并行或 layout 用 zellij。应在用户或任务出现「终端/命令行/shell/CLI」「在机器上跑/验证」「搜仓库/找文件」「看 diff 或 JSON」「查 PR/Issue/GitHub」「磁盘/进程/性能对比」「并行跑多个服务或测试」「tmux 式多会话」或 agent 需用上述工具链而非仅靠编辑器时加载。
12maintenance-pass
适用于“维护老坑”“接着做下去”“修一下这个 repo”“挑下一步最值得做的点”“这个项目有点乱先帮我收一收”这类任务。只要重点是基于现状继续向前,而不是从零设计,就应使用。
7modern-python
用现代 Python 工具链(uv、ruff、ty)初始化或改造项目:生成/调整 pyproject.toml、本地检查命令、预提交与 CI 模板;按项目最低版本(默认 >=3.12,尽量用最新稳定小版本)从 3.12 起叠读各版 What's New 以利用新特性。应在「新建 Python 项目」「写独立脚本要可维护」「统一 lint/format/类型检查」或用户提到 uv/ruff/ty/Python 工程化时加载;与 tech-preferences 的 Python 基线一致,本 skill 负责落地步骤与文件内容。
6