I made my coding agent explain every change to the customer. Here is the skill.
说明与用途
product‑engineer 技能强制编码代理在提交中添加面向客户的说明块,阐明更改内容、重要性、观察到的行为和未实现的功能,从而提升沟通和规则遵从性。
问题
Coding agents often fail to communicate changes to customers in plain language, leaving customers unaware of what was actually done and why it matters.
结果
The skill improves customer communication by ensuring every commit contains a clear, plain‑language explanation of changes, observed behavior, and omitted features. It also enforces consistency across languages and integrates with existing CI tools.
工作流
- Install the product‑engineer skill via npx or plugin marketplace.
- Configure the agent to use the skill (or individual rules).
- Write a commit message following the seven‑rule template.
- Run the agent; it generates the customer block and checks for compliance.
- If the block is missing or incomplete, the commit‑msg hook rejects the commit with a clear error.
- Merge the PR; the CI comments with the updated customer block and compliance status.
- Use the skill’s check command to validate existing commits or PR bodies.
- Optionally run product‑engineer doctor to verify skill installation and sync.
证据
The customer block went from 0/8 to 8/8, an observation or an honest "could not check" before "done" from 1/8 to 7/8, naming what was deliberately not built from 2/8 to 7/8.
If you want the rule enforced rather than suggested: sh scripts/install-hook.sh
- 记录日期: 2026-09-18T05:30:30.664Z