propose
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChinesePropose
Propose(提案)
Evaluate an idea honestly, then write when it is worth pursuing. The proposal explains
the motivation deeply, bounds the change at a high level, and sketches only enough technical approach
to establish feasibility and expose structural risk. Detailed behavior belongs in specifications;
detailed architecture belongs in .
proposal.mddesign.md如实评估一个创意,只有在值得推进时才编写 。提案应深入说明动机,从高层面上界定变更范围,并且只勾勒足够的技术方案,以验证可行性并暴露结构性风险。详细行为应放在规格说明中;详细架构应放在 中。
proposal.mddesign.mdProcess
流程
1. Understand and research
1. 理解与研究
Use when the problem, audience, desired outcome, success criteria, constraints,
or scope boundaries are unclear. Do not draft from a rough idea when an answer would materially change
the proposal.
codagent:ask-questionsGround the evaluation in available evidence:
- read related specifications and relevant code to understand current behavior, architecture, and existing patterns;
- investigate prior attempts, available tools, and credible alternatives;
- use web research when current external practices, products, or known pitfalls matter.
当问题、目标受众、期望结果、成功标准、约束条件或范围边界不清晰时,使用 。如果某个答案会实质性改变提案内容,不要基于粗略想法直接起草文档。
codagent:ask-questions根据现有证据进行评估:
- 阅读相关规格说明和代码,以了解当前行为、架构和既有模式;
- 调查此前的尝试、可用工具以及可信的替代方案;
- 当当前的外部实践、产品或已知陷阱很重要时,开展 Web 调研。
2. Evaluate
2. 评估
Assess the problem's significance, alternatives to building, opportunity cost, maintenance burden, and
fit with the existing system. Give a direct verdict: go, go with caveats, or no-go, with the
reasons and any condition that would change it. A no-go produces no proposal unless the user decides to
proceed after discussing the trade-offs.
评估问题的重要性、可采用的替代方案、机会成本、维护负担,以及与现有系统的契合度。给出明确结论:go、go with caveats 或 no-go,并说明理由以及会改变该结论的条件。若结论为 no-go,则不生成提案,除非用户在讨论权衡后决定继续推进。
3. Establish the high-level approach
3. 确定高层方案
For a viable idea, identify the minimum useful scope, affected capabilities, architecture fit, major
technical decisions, and material risks. When real alternatives exist, recommend one and explain the
important trade-off; ask the user only when the choice changes product scope or direction. Decide
low-risk implementation defaults from repository context.
Keep this intentionally lighter than design. Use a diagram or comparison only when it clarifies an
important relationship or decision.
对于可行的创意,明确最小有效范围、受影响的能力、与架构的契合度、关键技术决策和重大风险。存在真正可行的替代方案时,推荐其中一种并解释重要权衡;只有当选择会改变产品范围或方向时才询问用户。根据仓库上下文确定低风险的实现默认值。
这应有意比设计文档更精简。只有在图示或对比能够澄清重要关系或决策时,才使用它们。
4. Approve and write
4. 审批并撰写
Present the recommendation, scope, and approach for user approval before writing. Include any
consequential assumptions or defaults you selected so the user can correct them.
Use a caller-supplied or project-defined output path. Otherwise propose
and confirm it with the user.
~/.agent-skills/changes/<kebab-slug>/proposal.mdWrite the approved proposal with the structure below. Do not invoke another lifecycle skill.
编写前,先向用户提交建议、范围和方案以供审批。列出所有影响重大的假设或已选默认值,以便用户纠正。
使用调用方提供或项目定义的输出路径。否则,建议使用 ,并向用户确认。
~/.agent-skills/changes/<kebab-slug>/proposal.md按以下结构撰写已获批准的提案。不要调用其他生命周期 skill。
Artifact template
交付物模板
markdown
undefinedmarkdown
undefinedWhy
Why
<!-- Problem or opportunity, affected audience, and why it matters now. -->
<!-- Problem or opportunity, affected audience, and why it matters now. -->
What Changes
What Changes
<!-- High-level scope. Mark breaking changes with **BREAKING**. -->
<!-- High-level scope. Mark breaking changes with **BREAKING**. -->
Capabilities
Capabilities
New Capabilities
New Capabilities
- : <behavioral area that needs a new spec>
<kebab-name>
- : <behavioral area that needs a new spec>
<kebab-name>
Modified Capabilities
Modified Capabilities
- : <existing requirements that change>
<existing-name>
- : <existing requirements that change>
<existing-name>
Technical Approach
Technical Approach
<!-- Overall architecture fit and key decisions; leave detailed design for design.md. -->
<!-- Overall architecture fit and key decisions; leave detailed design for design.md. -->
Out of Scope
Out of Scope
<!-- Explicit exclusions that prevent scope creep. -->
<!-- Explicit exclusions that prevent scope creep. -->
Impact
Impact
<!-- Affected code, APIs, dependencies, systems, or users. -->
undefined<!-- Affected code, APIs, dependencies, systems, or users. -->
undefined