Skip to content
cccskills
FreePublished on GitHub

engineering-workflow

Guide development from problem definition and planning through testing, debugging, review, and final verification. It uses test-driven development, writing a failing test before implementation, and requires evidence before reporting work as complete.

OriginalShow the original description

可靠工程工作流的执行细则——探索→计划→TDD→系统化调试→代码审查→完成前验证。供方法论教练在开发任务中逐步引导。

See how to install

Good for

  • Define a development goal and acceptance checks
  • Implement a change starting with a failing test
  • Investigate a reproducible bug through small experiments
  • Prepare review and verification evidence before a pull request

Files included (1)

  • SKILL.md2.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

可靠工程工作流(执行细则)

当进入一个开发任务时,按下述顺序推进。每个阶段都要有"可验证的出口",不要跳步。

阶段 1 — 探索(Brainstorming)

  • 先回答:要解决什么问题?成功长什么样?边界与约束是什么?
  • 不确定就向用户提问,不要假设。产出清晰的问题定义。

阶段 2 — 计划(Writing Plans)

多步骤任务先写书面计划:

目标:<一句话>
步骤:
  1. <步骤> — 验收点:<如何确认完成>
  2. ...
风险:<已知坑>

计划被确认后再写代码。小改动可省显式计划,但验证不能省。

阶段 3 — 测试驱动(TDD)

  1. 写一个会失败的测试,定义"完成"的边界。
  2. 写最小实现让测试变绿。
  3. 重构,保持测试绿。 禁止"先写一大堆实现再补测试"——那等于没有验收。

阶段 4 — 系统化调试(Systematic Debugging)

遇到失败:

  1. 复现:找到稳定复现的最小输入。
  2. 观察:用日志/断点/打印建立信号,定位出错层。
  3. 假设:提出 1–3 个可能根因。
  4. 实验:用最小改动逐一验证假设,排除。
  5. 修复:定位根因后再改,不靠猜。 禁止:盲目改代码碰运气、同一 prompt 无限重试。

阶段 5 — 代码审查(Requesting / Receiving)

  • 合并前主动请求审查;自查清单:正确性、边界、错误处理、可维护性、测试覆盖。
  • 收到审查意见:逐条理解并回应,不因"小"而忽略;要反驳也得给依据。

阶段 6 — 完成前验证(Verification Before Completion)

声称完成前必须有证据:

  • 测试通过(贴输出或明确说明)
  • 命令/脚本实际跑过
  • 关键行为被确认 没有证据就闭嘴,不要说"应该没问题"。

收尾(Finishing a Development Branch)

功能完成 → 引导合并 / 提 PR / 清理分支。用约定式提交,中文 commit 清晰说明意图。

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Review a design or web page against WCAG 2.1 AA, an accessibility standard. Organize findings on contrast, keyboard access, forms, and screen reader behavior, with severity levels and practical recommendations for fixes.

  • Review accessibility before design handoff
  • Check text and interface color contrast
  • Review keyboard navigation and focus behavior
TencentCloud/Octop9.9KUpdated Oct 18, 2026

akshare-data

FreeSummary

Retrieve financial data for Chinese markets and selected global markets using akshare-cli. Find stock prices, fund values, exchange rates, economic indicators, and financial news, then extract recent records or save results in common file formats.

  • Retrieve historical prices for Chinese, Hong Kong, or US stocks
  • Check fund and ETF net asset values
  • Look up exchange rates and economic indicators
TencentCloud/Octop9.9KUpdated Oct 18, 2026

architecture

FreeSummary

Compare technology options, review a system design, or plan a new component from requirements and constraints. The skill organizes the reasoning into an architecture decision record, a document covering alternatives, trade-offs, consequences, and next steps.

  • Compare technologies before choosing one
  • Document the reasoning behind a design decision
  • Review a proposed system design
TencentCloud/Octop9.9KUpdated Oct 18, 2026

bo-process-doc

FreeSummary

Turn existing or proposed business processes into reusable standard operating procedures. Organize steps, roles, conditions, and known exceptions while marking missing details, producing clear handover documents without inventing approvals or responsibilities.

  • Turning workflow notes into a standard operating procedure
  • Preparing process documentation for a handover
  • Clarifying assignment, execution, and review responsibilities
TencentCloud/Octop9.9KUpdated Oct 18, 2026

Analyze waiting, rework, and handoff waste in business processes using the facts provided. It proposes concrete improvements and, when verification is needed, defines measurement formulas and the minimum records required to assess specific issues.

  • Reviewing waiting and rework in an existing workflow
  • Requesting a fixed number of concrete improvement suggestions
  • Defining records to distinguish processing time from waiting
TencentCloud/Octop9.9KUpdated Oct 18, 2026

Assess operational risks in processes, projects, or suppliers using provided evidence. Separate observed facts from possible consequences, propose practical responses, and prepare concise summaries or risk registers without treating unknown controls as confirmed gaps.

  • Assess risks in business processes
  • Review operational risks in projects or suppliers
  • Prepare a risk register
TencentCloud/Octop9.9KUpdated Oct 18, 2026

See all skills by TencentCloud

Report a problem with this skill