用途
core-workflow 是一份综合性的开发工作流参考,作为技能在需要时按需加载,用于处理复杂任务、规划、调试或需要明确模式(explicit patterns)的场景。它包含会话协议、Git 约定、安全检查清单、基于审查的验证(review-based validation)以及沟通标准。其目标是为开发过程提供统一、可复用的流程模式与判断依据。
主要能力
会话协议:提供开始与结束会话的检查清单。开始会话时先同步:从 origin/HEAD 取默认分支、fetch 并 prune、仅快进合并;查看最近 3 条提交记录;检查 tasks 目录下是否有进行中的任务文件。结束会话时通过审查验证(重新阅读请求和完整 diff,而非测试/类型检查阶梯),归档已完成任务,按要求提交并推送(不得强推),并停止自己启动的开发服务器。日期应取环境上下文中的当天日期,而非自行推断。
工作规模划分:按复杂度选择流程。简单修复(少于 30 分钟)直接执行;单一功能(30 分钟至 2 小时)建立任务文件并使用 TodoWrite;多阶段功能(以天计)先进入计划模式,再在 tasks/ 中每个阶段一个任务文件;新项目/应用先运行 /init-project,再对第一阶段进入计划模式。
Git 约定:提交类型包括 feat、fix、refactor、perf、test、docs、chore。提交信息格式包含简短的 type 摘要(最长 50 字符),以及 What Changed(改了什么文件)、Why(为什么改)、Verification(如何通过审查验证)三部分。任务或计划完成时可自动提交,无需被要求,但需先做提交前检查:确认是用户自有仓库(origin 不匹配 travisjneuman 则视为外部),并检查推送是否被阻止(push URL 含 no_push)。规则为:用户自有仓库可自动提交并推送;外部仓库(no_push)与外部子模块绝不提交,只读;检测到未提交的密钥则阻止并警告用户。
安全检查清单:前端包括使用 textContent 而非 innerHTML、外部数据使用 unknown 类型、不暴露 API 密钥、外部请求使用 HTTPS、输入净化。后端包括所有端点输入校验、受保护路由有鉴权守卫、参数化查询(不用裸 SQL)、密钥存放于环境变量。
性能与无障碍目标:初始包小于 100KB gzip、页面加载小于 1 秒、交互延迟小于 100ms、Lighthouse 性能 95 以上、无障碍至少 WCAG AA。WCAG AA 清单包括语义化 HTML、有意义图片提供替代文本、键盘导航(Tab、Enter、Escape)、可见焦点指示、颜色对比度不低于 4.5:1、交互元素带 ARIA 标签、触控目标不小于 44x44px。
思考框架:用于复杂决策,按决策类型选择,如长期影响用 /consider:10-10-10、根因分析用 /consider:5-whys、优先级用 /consider:eisenhower-matrix、创新用 /consider:first-principles、风险识别用 /consider:inversion、简化用 /consider:occams-razor、聚焦用 /consider:one-thing、权衡用 /consider:opportunity-cost、优化用 /consider:pareto、后果用 /consider:second-order。
调试协议:标准问题按复现、阅读相关代码、定位根因、修复根因、通过审查 diff 与修复输出进行验证的步骤处理;间歇性/复杂问题使用 debug-systematic 技能。
自建与采用第三方库:原则是“我们构建功能,使用工具”。功能逻辑、业务规则、UI/UX、数据模型自行构建;底层抽象(如 D3、Recharts、Lexical、Konva)直接使用。许可要求:必须使用 MIT、Apache 2.0、BSD,绝不使用 GPL、AGPL。
沟通标准:进度更新应给出高层摘要而非刷屏。仅在缺少关键选择且会改变结果、指令冲突且优先级无法解决、破坏性或外部目标无法精确识别、步骤所需权限未在请求中授予时,才使用 AskUserQuestion;否则选择合理选项继续,并说明假设。直接性协议强调逻辑优先于情感、正确性优先于认可、直接反馈优先于委婉、最优方案优先于一致。
上下文卫生:减少 token 使用,用简短高信号摘要代替长日志,默认不通过 @ 嵌入大文档,改为引用路径并说明何时读取,完成工作单元后使用 /clear。委派模式:上下文超过 100k token 时创建提示词并委派到全新上下文;中等复杂度用 /create-prompt 后 /run-prompt;多阶段功能用 /create-meta-prompt;接近上限时用 /whats-next 生成交接文档。
常用命令与文件命名:npm run dev 启动开发服务器、npm run build 生产构建、npm run test 运行测试(仅在用户要求时)、npm run type-check 类型检查(仅在用户要求时)。文件命名:组件用 PascalCase(如 UserCard.tsx)、钩子用 use 前缀(如 useAuth.ts)、工具用 camelCase(如 utils.ts)、测试用 .test.ts(如 utils.test.ts)。
使用方式
该技能以技能形式提供,针对复杂任务自动加载,或按需加载以获取详细模式。相关规则与清单位于 ~/.claude/rules/ 下,按技术栈与任务类型组织。同时可参考 ~/.claude/docs/reference/checklists/、stacks/、tooling/ 等目录,以及 ~/.claude/skills/MASTER_INDEX.md 技能目录和 ~/.claude/agents/README.md 代理目录。安装与调用命令在给定资料中暂未提供。
适用场景
适合在 Claude Code 环境中进行软件开发时,作为标准化工作流参考使用,尤其适用于复杂任务、任务规划、调试、需要明确开发模式、代码提交与审查、安全检查、性能与无障碍要求确认、上下文管理与任务委派等场景。
限制
资料未说明该技能的具体安装步骤、依赖版本或收费信息。其检查清单、性能目标与安全条目为规范建议,实际效果取决于执行环境与项目条件,资料未提供可验证的效果数据。